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SECTION I 
GENERAL DESCRIPTION 



INTRODUCTION 



The HP Real-Time Executive File Manager Pack- 
age (FMP) is a programmer/operator interface to the 
Real-Time Executive (RTE) that is used to organize and 
systematize files on the RTE System to make access and 
maintenance easier. The FMP maintains files on an HP 
Real-Time System on one or more discs, and provides a 
uniform access method to all standard HP Input/Output 
devices. The FMP provides easy-to-use access methods in 
the form of operator commands entered through the system 
input device, or user program commands accessing one of 
the many FMP subroutines. All details of file access, includ- 
ing multiprogramming protection, are built into the FMP. 



CAUTION 



To avoid disruption of data storage, the disc 
controller and removable disc cartridge must not 
be exposed to an area where a strong magnetic 
field may be present. 

The File Manager performs the following functions: 

• Provides security on system and file level to prevent 
unauthorized access. 

• Creates new files; modifies existing files; and purges 
obsolete files. 

• Provides exclusive control of I/O devices, other than 
discs, which use standard peripheral calling sequences. 

SOFTWARE 

Table 1-1 is a list of the software and other components 
that make up the File Manager Package. 



Table 1-1. FMP Components 


Description 


Part Number 


FMP Program Tapes 


29033-60001 lof3 




29033-60001 2 of 3 




29033-60001 3 of 3 


FMP Library Tape 


29033-60002 1 of 1 


FMP Manual 


29033-98000 


FMP Listings 


29033-98002 



The File Manager operates within the HP RTE software 
environment as follows: 

HP RTE Software compatible with the File Manager 

29014A or later RTE Moving Head Generator 

2901 5 A or later RTE Fixed Head Generator 

290 16D or later RTE System 

29022A or later RTE Relocating Loader 

29029A or later RTE Multiple-Device System Control 
Driver. 

HARDWARE 

The File Manager operates within the HP RTE hardware 
environment which consists of an HP 9600 Series System. 

HP 9600E — Disc-based Real-Time Executive using 
moving head disc. 

HP 9600F — Disc based Real-Time Executive using fixed- 
head-per-track disc. 



FMP PHILOSOPHY 

A file management system has the task of organizing infor- 
mation into an easy-to-use scheme. However, what is a file 
management system? Because of the many different things 
that can be filed, and the many different ways they can be 
filed, there are many different views on exactly what a 
filing system is all about. The HP File Manager system 
(FMP) is versatile enough to allow a user to configure his 
own filing system to suit his individual needs. But before 
an attempt is made to describe the technical aspects of the 
FMP, including all the versatility, a common ground must 
be established with regards to file management. A simple 
analogy can be used that will aid in understanding what it 
does. Refer to Figure 1-1 for the analogy example. For 
the more technically oriented individual that understands a 
file management system, refer to the technical discussion 
later in this section. For the uninformed — read on. 
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FILE. Each file will have its own six 
character name. This name wi 1 1 
be stored in the file directory 
on this disc. 



RECORD. Records are user defined, and 
are in numerical order within 
the file. 



Figure 1-1. Analogy of the RTE FMP 



RECORD ITEM. 



Record items are user 
defined and are in 
numerical order within 
the record. 
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FMP GENERAL DESCRIPTION 

As soon as anyone accumulates a few thousand of anything 
(except money), he may have a problem storing his accu- 
mulation, and then finding what he needs when it is 
required. As the collection grows and as time passes, the 
memory dims and the point is reached when this file grows 
so large that needed references cannot be found, and that 
forgotten items are without access. There are then, three 
basic problems to overcome; 



Problem 

• Where do you store vast 
collections? 

• How do you manage the 
collections? 

• How do you remember 
what's in the collection? 



Solution 

Within the HP RTE 
System 

With the HP RTE File 
Manager. 

Through a unique index 
scheme of your own 
built upon the index 
features of the File 
Manager. 



SOLUTION DEFINITIONS 



HP RTE System is a multiprogramming system that allows 
several programs to operate concurrently, each program 
executing during the unused central processor time of the 
others. (A complete description is contained in the RTE 
Programming and Operating Manual 02005-90001.) RTE 
can provide from 2.5 million to 10 million 16-bit words of 
storage on fixed head or moving head discs, or a combina- 
tion of both. 

HP RTE File Manager is a programmer/operator interface 
to the RTE that is used to organize and systematize files on 
the RTE System to make access and maintenance easier. 

Index Schemes come in many different forms for many 
different applications. The user must be concerned with a 
minimum of two indexes; one that the File Manager itself 
forms and maintains, and one that the user should form for 
cross-referencing purposes. 

ANALOGY 

As shown in Figure 1-1 the HP RTE System is likened to a 
large filing cabinet that is capable of storing a very large 
quantity of information. The HP RTE File Manager (FMP) 
can be compared to an office clerk that is responsible for 



taking care of the filing system. The responsibilities of the 
FMP, using the office clerk analogy, would be as follows: 

• To set up the entire filing system with a system security 
code according to the dictates of the user. The user pro- 
vides the individual file names and the type of each file. 
The user can also flag each file with a security code so 
the FMP can check another user's right to examine a 
particular file. 

• The FMP will allow the user to: 

Add new files 

Open an existing file to: 
Add records 
Delete records 
Change records 
Copy records or information 

Close an opened file (return it to the system) 

Purge an obsolete file. 

• The FMP will resolve conflicts between users who want 
to open the same file. A user may request that a file be 
opened exclusively to him. This will be granted by the 
FMP only if the file is not in use. A user may request 
that a file be opened non-exclusively, that is, he will 
share it. Each time a request is received to open a file, 
exclusively or non-exclusively, all users that currently 
have that file open are checked. If they are not current- 
ly using the file, it is closed to them and returned to the 
system. The FMP will grant the non-exclusive opening 
of a file only if it is not already exclusively open, or 
already being shared by more than seven users. 

• The FMP can understand users that talk in FORTRAN 
IV, FORTRAN II, ALGOL, and HP ASSEMBLER. 

• The FMP will communicate messages to the user that 
will inform him of mistakes he has made in filing. FMP 
will also communicate messages in regard to overall 
system performance. 

The previously described responsibilities or qualifications 
are only a general indication of how the FMP manages and 
organizes user files. The FMP is versatile enough so that 
the user can configure the filing system to suit his individu- 
al needs. The FMP will recognize user requests via the writ- 
ten memo method (programming) where the user details 
his instructions completely, or by the simpler verbal direc- 
tive method (entries through the system input device). Both 
methods are described in Sections II and III, respectively. 
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A key to effective use of the FMP is organization. How to 
organize large collections in order to find any single item 
easily. The FMP will do the actual filing and housekeeping 
but you must organize and index your items for efficient 
retrieval. Refer to Appendix H at the rear of this manual 
for additional information on indexing. 

FMP TECHNICAL DISCUSSION 

Many different terms related to the HP File Manager ap- 
pear throughout this manual. For convenience these 
terms are all defined below. 



b. When the FMP is performing a non- 
disc WRITE: 

1 . An EOF is requested for a magnetic 
tape or cassette, — or — 

2. A double space (two carriage return/ 
line feeds) is entered on the tele- 
type, — or — 

3. A page eject control function is 
used for the line printer, — or — 



CARTRIDGE 



FILE 



RECORD 



EOF 



This term is used interchangeably with 
disc and means a rotating random access 
storage device. Cartridge usually implies 
removability. 

A collection of records usually terminated 
by an End-Of-File (EOF). A file may 
have zero or more records in it. In the 
FMP, a disc file is usually designated by a 
unique six character name. 

A collection of 16-bit words usually ter- 
minated by an End-Of-Record (EOR) 
mark. A record may have zero or more 
words in it. FMP Record formats are 
described in detail under File Types. 

An end-of-data mark of higher level than 
an EOR mark. The particular type of 
EOF mark is determined by the type of 
device referenced. 

FMP EOF Conventions: 

a. When the FMP is performing a non- 
disc READ: 

1. Magnetic tape, cassette, and card 
reader use bit 7 in the STATUS 
word, — or — 

2. A zero length record and the device 
is up (card reader encountering a 
blank card), — or - 

3. A zero length record and the device 
type is less than 10 (i.e., DVR00 to 
DVR09). 



SECTOR 



BLOCK 



4. A leader control request is used for 
paper tape. 

c. When the FMP is performing a disc 
READ or WRITE, the EOF is defined 
by the file type (see File Types). 

A sector is part of a disc track 64 words 
in length. 

Two disc track sectors of 64 words each 
(total of 128 words). 



FMP ORGANIZATION 

File Organization . Files may exist on the disc tracks known 
by the system (i.e., system and auxiliary discs), and on 
peripheral discs. Tracks on the system and auxiliary discs 
are FMP assigned so that only FMP routines may write on 
them. Files are directed to preferred discs by the user. If a 
particular disc is not selected in the call, the FMP will direct 
the file to a convenient location — the user does not have to 
remember track and sector addresses, just the file name and 
security code. 

Disc Organization . Disc files are located on contiguous 
tracks within the FMP area, with user files beginning on the 
first (lowest numbered) FMP track and working up, and 
directory entries for the user files beginning on the last 
(highest numbered) FMP track and working down. No file 
will be allowed to cross a disc boundary; however, the as- 
signed file area may include several discs. All track numbers 
refer to relative track numbers, that is relative to the track 
on the given unit established as track at system genera- 
tion time. For fixed-head discs, physical track and 
relative track are the same. For moving-head discs, 
relative track is established during RTGEN time. 
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NOTE 

For moving-head discs, all starting track numbers 
must be the same if the cartridges are to be 
exchanged LU to LU or system to system. This 
is due to the fact that FMP uses relative track 
addresses in the directory. 

All files are subject to moving as part of any packing opera- 
tion done on a disc. This makes files relocatable; therefore, 
no absolute file addresses should be retained in any file or 
program. 

Blocks are defined as two disc sectors of 64 words each. 
All files are constrained to start on even sector boundaries 
and all accesses, except to type 1 files, are 128-word ac- 
cesses. Therefore, all accesses are directed to even sectors. 
No cyclic checking is done, and all disc errors are passed 
back to the caller for action. The error code is printed on 
the system log device when using the FMGR operator inter- 
face routine, or passed to the user program in parameter 
IERR when using one of the library subroutines. 

BAD TRACKS 

Bad track information is entered using the FMGR Initializa- 
tion Command. This information is kept in the affected 
disc's first directory entry. If, at creation or during a pack- 
ing move, the area for the file includes a bad track, the first 
track of that file will be increased until the file no longer 
contains any bad tracks. If the CREAT routine is to use the 
rest of the disc, the whole area will be above the highest bad 
track. If, during packing, a file is found to include a de- 
clared bad track, the file will be purged. (Note: This can 
only happen through an explicit declaration of a bad track 
by an operator who knows the system security code.) In 
this manner, only the PACK and CREAT routines need be 
aware of bad tracks. Bad tracks discovered by the FMP 
result in an error return to the caller. 

DIRECTORIES 

The FMP creates and maintains two indices. The master in- 
dex, or disc directory, contains information on all discs 
assigned to the FMP, and the local index or file directory 
contains information on each file on that particular disc. 

Disc Directory . The first two sectors of the last track of the 
system disc (LU2) that is assigned to the FMP contains in- 
formation on all discs which are currently mounted and 
which contain tracks assigned to the FMP. This directory 
also contains a setup code word and the master security 
code. The layout of this directory is shown in Appendix A. 



File Directory . Each disc which has tracks assigned to the 
FMP will contain a file directory. Each file directory entry 
uses 16 words. The file directory starts in sector of the 
last track which is available to the FMP. The first entry in 
the file directory will pertain to the disc itself and will con- 
tain label and track information. Each subsequent entry 
will contain information on a file. The last entry will be 
followed by a zero word. The first entry and each entry for 
purged files has the sign bit set on its first word to indicate 
that it is normally to be ignored. Refer to Appendix A for 
the file directory format. 

FILE TYPES 

Files are divided into three categories shown below: 

Category Type Description 

Control | Non-disc file 

1 128-word record length 

2 User selected record length 

3 Random record length 



Fixed lengths, 
random access, 
non-extendable 



Random length, 
sequential 
access, auto- 
matic extents 


4 
5 
6 


Source program 
Relocatable program 
RTE load module 




7 


Absolute program 




>7 


User defined 



Type 0. A type file is created with the CR Operator 
Command, and is used to control devices other than discs. 
Type files also afford a measure of device independence, 
in that the standard file commands can be used to control 
the device. A type file can only be created on the system 
disc (LU2); therefore, the file directory entry will be located 
in the system disc file directory, and have some special en- 
tries relating to logical unit number and end-of-file code. 
Cooperating programs may use type files as a means of 
controlling access to a device (see exclusive open). 

Type 1 . Type 1 files have fixed record lengths of 128 
words. Since the smallest addressable block is 1 28 words, 
short blocks will be filled from the user's buffer. Transfers 
to or from type 1 files are done directly to or from the 
user's buffer, and may be any length; thus, this type file has 
the fastest transfer rate. Positioning on type 1 files assumes 
a record length of 128 words. Any file except type may 
be opened as a type 1 file. 
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Type 2. Type 2 files have record lengths that are user de- 
fined. Each transfer is one and only one record long, and 
must go through a packing buffer (128 word buffer in the 
Data Control Block); thus, the transfer rate will be slower 
than type 1 files. 

Type 3 . Type 3 files are packed on the disc and contain 
data, source, relocatable, etc. Each transfer is one and only 
one record long, and must go through a packing buffer 
(128 word buffer in the Data Control Block). 

Type 4 . Same as type 3, except the FMGR operator inter- 
face routine recognizes (defaults) type 4 files as containing 
source programs. 

Type 5 . Same as type 3, except the FMGR operator inter- 
face routine recognizes (defaults) type 5 files as containing 
relocatable binary code. 

Type 6 . Same as type 3. This file is created by the Save 
Program (SP) operator command as a type 6 file, but is 
always accessed as a type 1 file. Refer to RECORD FOR- 
MAT heading under type 6, and the SP Command for 
more information. 

Type 7 . Same as type 3, except the FMGR operator inter- 
face routine recognizes (defaults) type 7 files as containing 
absolute binary code. 

Type >7 . Same as type 3 — user defined. 

All files, except type files, may be accessed as type 1 (i.e., 
direct transfer through user's buffer); however, no other 
type modification is allowed. The major difference between 
the files is the speed of positioning. A type 1 or 2 file may 
be positioned without any disc accessing, whereas other 
type files require at least one, and in some cases, several 
accesses. The user in no case need worry about a file 
crossing sector or track boundaries. 

Update Files. Update implies that a file is to be modified 
in some manner. It is usually desirable to modify only a 
portion of the file without disturbing the remainder of the 
contents. 

The end-of-file mark of type 1 and 2 files is the last word of 
the last block in the file; however, in other type files it is a 
special word (-1) for the length of a record. In order to 
preserve data in a type 2 file, it should be opened for up- 
date whenever any non-sequential accesses are to be per- 
formed, and the file is to be modified. That is to say, a 
type 2 file should be modified in non-update mode only 
when originally writing the file, or adding to the end of the 
file, and then only if it is to be written sequentially. Up- 
date/non-update has no effect on reading or positioning. 



In files of type 3 and above, an end-of-file mark is written 
in the non-update mode. In either mode, records written 
beyond an end-of-file are written in non-update fashion. 
That is, replace the end-of-file with the new record, fol- 
lowed by an end-of-file. 

Extendable Files. An extendable file (type 3 and up) is a 
file that is automatically extended in response to a write 
request to points beyond the range of the currently defined 
file. The extent is created with the same name and size, 
and the access is continued. Extensions will be of the same 
size as the base file, and all extensions of any given file will 
be on the same disc. No flags or pointers relating to the 
next extent are kept in the file area. Open flags are kept 
only in the base file directory entry. 

RECORD FORMATS OF FILES 

Type . The type file's record is defined by the device 
type. The following description describes type files from 
paper tape and card devices. (These conventions are incor- 
porated in the device driver and not the FMP.) 

a. ASCII 

1 . ASCII records are punched according to the 
table in Appendix E. 

2. On paper tape, records are ended with a line 
feed character (usually preceded by a carriage 
return). A rubout character anywhere in the 
record indicates that the record is to be ignored. 
Backspace characters cause the previous char- 
acter and backspace character to be deleted 
from the record. 

3. On cards, records are terminated explicitly by 
the highest non-blank character position, less 
than or equal to the read request length. 

b. Relocatable Binary Records. 

1 . The complete format is given in Appendix F. 
The FMGR program uses the length and check- 
sum words to do checksum on relocatable 
records. 

c. Binary Records. 

1. Binary records have the length in word one 
(first character) and the rest is unspecified. 
These records are generated by binary write re- 
quests to the formatter directed to a paper tape 
device. A checksum is not performed. 
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d. Absolute Binary. 

1 . The Absolute format is given in Appendix G. 
This record type is used on tapes usually loaded 
by the Basic Binary Loader (BBL) or the Basic 
Binary Disc Loader (BBDL). The FMGR pro- 
gram uses the first and last words to perform a 
checksum on these records. It is also necessary 
to set subfunction bits (23 8 ) to read absolute 
records. 

Ty pe 1 and 2. Type 1 and 2 files are written as presented. 
They are packed, and may cross sector and track bound- 
aries. The end-of-file is the last word of the last block in 
the file. 

Ty pe 3. 4. 5. 6. 7 and Above. Type 3 and above records 
are preceded and followed by a length word which contains 
the length of the record (exclusive of the two length words). 
A zero length record consists of two zero words. An end- 
of-file is indicated by a - 1 for the first length word. Words 
following the end-of-file are undefined. 

Type 6. Program Save Files are created as type 6 files by 
the SP Command, and are always accessed as type 1 files 
by FMGR. 

The first two sectors of the file are used to record ID in- 
formation on the program as follows: 



Word No. 


Contents 





- 1 (EOF if not forced to type 1) 


1 thru 5 


Not used 


6 


Priority 


7 


Primary entry point 


8 thru 13 


Not used 


14 


Program type 


15 thru 16 


Not used 


17 thru 21 


Time parameters 


22 


Low main address 


23 


High main address 


24 


Low base-page address 


25 


High base-page address 


26 thru 27 


Not used 


28 


Checksum of words thru 27 


29 


System setup code word (same as disc 
directory word 125) 


30 thru 127 


Not used 



The remainder of the file will be an exact copy of the 
original program tracks. 



MULTIPROGRAMMING CONSIDERATIONS 

File Conflict . In order to prevent two or more programs 
from destructively interfering with each other, a file may be 
opened either exclusively or non-exclusively. 

Exclusive Open . An exclusive open is granted only to one 
program per file at a time. 

Non-Exclusive Open. A non-exclusive open may be granted 
to as many as seven programs per file at one time. A non- 
exclusive open will not be granted if the file is already 
opened exclusively. 

Directory Conflict. The FMP keeps open flags in the 
directory. This means that the directory will be modified 
by the following functions: 

• Creating a file 

• Opening a file 

• Closing a file 

• Purging a file 

• Changing a file name. 

Since all these actions may be programmed by the user, it 
is clear that there could be conflict. The FMP resolves 
this conflict by allowing only one program to write on the 
directory tracks. This program is the D.RTR routine. 
D.RTR is scheduled with wait whenever a directory change 
is required; that is, for all of the above functions. D.RTR 
must be either foreground disc resident or core resident 
for this reason. The D.RTR program will own outright 
the directory on LU2, and LU3, if any. 

Security. There are two levels of security, file security 
and system security. 



File Security . Each file has a security code. This code 
may be positive, negative or 0. If positive and the code at 
open does not match, the file may be read but not written 
on. If negative and the code at open does not match, the 
file will not be opened. If zero, the file may be opened to 
any caller with no restrictions. 



System Security . During system setup, a system security 
code is entered. If zero, no security is given. If non-zero, 
the code must be known in order to get directory listings 
to include file security codes, and in order to redefine the 
FMP disc areas. 
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FMP PROGRAM CALLS 

The programmer communicates with the FMP through the 
type 6 or 7 utility subroutines provided on the FMP library 
tape. The subroutines will perform the following functions: 

• Position a file to a known record address 

• Close a file 

• Create a file 

• Send RTE control request to a type file 

• Return 1 25 words of Disc Directory 

• Return file status 

• Rename a file 

• Open a file 

• READ/WRITE a specific record 

• Purge a file 

• READ a file 



• Reset a file to first record; if type file, a rewind 
request is generated. 

• WRITE a file. 

FMGR OPERATOR COMMANDS 

The operator controls the FMP with operator requests en- 
tered through the system input device. The commands can 
be entered manually through the system teleprinter, or on 
paper tape, cards, or other form through the appropriate in- 
put device. The commands can also be stored in a file, with 
control being transferred to that file for execution. 

The operator first gains the attention of the FMP by sched- 
uling the software module FMGR with the ON FMGR oper- 
ator command. When FMGR runs, a colon (:) prompter is 
returned on the initial keyboard input device. If the input 
device is not a keyboard, the first command is read from 
the device that is the input. 

If desired, each command will be echoed on the system log 
device (refer to Severity Command). If an error is detected 
(input or reference), an error number is printed on the log 
device and input control is switched to that device. This 
halts the process and requires operator intervention to 
correct the error. 
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SECTION II 
FMP CALLS 



This section describes the basic format of Assembly 
Language calls to the various subroutines that interface the 
user program to the File Manager. Table 2-1 is a summary 
of the calls in this section and shows an interrelationship 
between the File Manager, program calls, Data Control 
Block (DCB), and user's program. The table is intended as 
an aid in understanding which calls to use for a given task , 
and how the DCB will be affected by the call. The error 
codes associated with the FMP calls are listed in Section IV. 
(Note that all error codes are also returned in the com- 
puter's A-Register.) Refer to Appendix C at the rear of 
this manual for a summary of the FMP calls and required 
parameters. 

SUBROUTINE STRUCTURE 

All the interface routines are type 6 or 7 utility sub- 
routines and are located on a single library tape. Type 7 
utility subroutines are subroutines which cannot be shared 
by several programs because of internal design or I/O oper- 
ations. A copy of the utility routine is appended to every 
program that calls for it. The RTE library subroutine 
FRMTR, which carries out FORTRAN I/O operations, and 
the PAUSE subroutine are examples of type 7 utility rou- 
tines. Type 6 re-entrant or privileged library routines are 
sharable and may be loaded in the core resident library area 
at system generation. The FTN IV Formatter is an example 
of a re-entrant routine, and .ENTR (the subroutine entry 
routine) is an example of a privileged routine. 

When RTGEN creates the disc-resident RTE System, all 
library subroutines not included in the resident library are 
stored on the disc in relocatable format as utility routines. 
They are appended to programs by the RTE Relocating 
Loader in its background loading process (see RTE Re- 
locating Loader in the RTE Manual). 

DEFINITIONS 

DATA CONTROL BLOCK (DCB) 

The DCB is a 144 word array provided by the user program 
with one DCB required for each file opened. Once a file is 
open, the DCB is used to reference the file, the name no 
longer being needed, or used. The DCB includes a 128 
word buffer area (block) that is used for data transfers. 

BLOCK 

A block is two sectors of 128 words. 



SECTOR 

The RTE moving head disc driver regards a track as having a 
user defined number of sectors of 64 words each. For pro- 
gramming purposes, all disc transfers are a maximum of 
128 words per transfer (one block) except for type 1 files. 
(Type 1 files do not use the DCB buffer area and are there- 
fore not restricted to 1 28 word transfers.) 

DISC DIRECTORY 

The first two sectors of the last track of the system disc 
(LU2) are devoted to the master index, or disc directory. 
The disc directory is always located on the system disc, and 
contains information on all discs which are currently 
mounted, and which contain tracks assigned to the FMP. 
This directory also contains a setup code word and the 
master security code. The layout or format of this direc- 
tory is shown in Appendix A. 

FILE DIRECTORIES 

Each disc which has tracks assigned to the FMP will contain 
a file directory. Each file directory entry uses 16 words of 
a sector. The file directory starts in sector of the last 
track which is available to the FMP. The first entry in the 
file directory will pertain to the disc itself and will contain 
label and track information. Each subsequent entry will 
contain information on a file. The last entry will be fol- 
lowed by a zero word. The first entry and each entry for 
purged files, has the sign bit set on its first word to indicate 
that it is a label and not the same name as a file (normally 
to be ignored). Refer to Appendix A for the file directory 
format. Note that while it is possible to have two files with 
the same name located on different cartridges, it is not 
possible to have two files with the same name on the same 
cartridge. 

D.RTR 

D.RTR is a foreground program which is an integral part of 
the FMP. D.RTR is the only program which is allowed to 
write on the directories, and may only be scheduled by 
some other program. D.RTR is never directly called by the 
user, it is called by the user interface subroutines only. 
D.RTR is called by a schedule with wait call to the RTE 
EXEC, and five parameters define the function desired. 
D.RTR will return up to five parameters which the calling 
routine may access with RMPAR. 
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Table 2-1 . FMP Calls and Data Control Block Relationship 



Subroutine 
Entry Point 


Function 


DCB Status 
At Entry 


DCB Status 
After Call 


Directory 

Access 


APOSN 
CLOSE 
CREAT 


Positions a file to a known record address 
Closes a file 
Creates a file 


MBO 
MBO 
CBO 


OPN 

CLO 

OPNEX 


EXTENTS 
YES 
YES 


FCONT 
FSTAT 
LOCF 


Sends RTE control request to type files 
Returns 1 25 words of Disc Directory 
Returns File status 


MBO 
MBO 


OPN 
OPN 


NO 
NO 


NAMF 
OPEN 
POSNT 


Renames specified file 

Opens desired file 

Directs next READ/WRITE to a specific 
record 


CBO 
CBO 
MBO 


CLO 
OPN 
OPN 


YES 

YES 

EXTENTS 


PURGE 
READF 


Removes file and directory entry 
Transfers one record from file to user buffer 


CBO 
MBO 


CLO 
OPN 


YES 
EXTENTS 


RWNDF 
WRITF 


Resets file to first record; if type file, a 
rewind request is generated 

Transfers one record from user buffer to 

file 


MBO 
MBO 


OPN 
OPN 


EXTENTS 
EXTENTS 


Legend: 

MBO = Must be open OPNEX = Open exclusively 

OPN = Open EXTENTS = Directory is accessed if there 
CBO = Can be open - if DCB is open, the current is a change of extents as a 
file opened to the DCB will be closed. result of the call. 


Summary: 

• As indicated from the table a file must be open to a DCB before making any of the following calls. 

APOSN FCONT POSNT RWNDF 
CLOSE LOCF READF WRITF 


• The only calls that result in 

• The above conditions imply 

A. To open a DCB, call ' 

B. To do something 
with a file, call 

C. To close a file, call 
-OR- 

D. To close a file and 
open another, call 

• A file should always be close 
being posted on the disc. 


i closed DCB being left open are OPEN and CREAT. 

that the general structure of a program using files be as follows: 

OPEN 
CREAT 

APOSN readf 
^°P T RWNDF 

i^T,L WRITF 
POSNT 

CLOSE 

OPEN 
I CREAT 

d before program termination. Failure to do so may result in the last block not 
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LOGICAL READ VS. PHYSICAL READ 



PARAMETERS 



A logical read occurs each time the user requests a record 
from a type 2 and above file. At that time FMP checks the 
specified Data Control Block (DCB) buffer area to deter- 
mine if the requested record is already in core. If in core, 
the record is transferred to the user's record buffer without 
actually physically reading the disc. If the record is not 
present in core, the necessary disc transfers are performed 
(physical reads — and writes, if necessary) to bring the 
record into core. If the record size is less than 128 words, 
then enough records (including possible partial records) 
are brought into core at once to total 1 28 words. 

LOGICAL WRITE VS. PHYSICAL WRITE 

A logical write occurs each time a user requests that a 
record be written to a type 2 and above file. At that time, 
FMP determines if that record is present in the DCB buffer 
area; if it is, FMP simply transfers the data in the user's 
record buffer to the DCB buffer area and flags it as "must 
be written." Each succeeding read or write is treated in the 
same manner until one of the following occurs: 

a. A logical record transfer occurs for which the 
record is not wholly in core. 

b. Until the file is closed. 

c. Until the file is repositioned to another block. 

In any one of these cases, the FMP must physically write 
on the disc (post) the records in the DCB buffer area. Fol- 
lowing this posting, any remaining words are moved to the 
DCB buffer area. 

If the record is not present in core on a write request, FMP 
locates the record on the disc and if update mode, transfers 
it physically into the DCB buffer area. The data to be 
written is then transferred from the user buffer to the DCB 
buffer area and flagged as "must be written." The read 
before write is necessary because records do not necessarily 
fall on sector boundaries in the disc. If a CLOSE, POSNT, 
APOSN, or RWNDF request occurs, all buffers flagged are 
written to the disc. 

NOTE 

Type and 1 files are transferred directly to or 
from the I/O device or disc (posted immediately). 



Most of the 13 subroutine calls shown in Table 2-1 use 
common parameters. Rather than list the meanings of 
these parameters 13 times, they are described here in detail 
as a preface to all the calls. Any parameter that is unique to 
a call is described within the call itself. 

GENERAL PARAMETERS 

IDCB is a 144-word array to be used as a Data Control 
block (DCB) for each file opened. Note that the 
DCB is free for other use after a PURGE, CLOSE 
and NAMF call. (The DCB is fully defined in 
Appendix A.) Once a file is open, the DCB is used 
to reference the file, the name no longer being 
needed, or used. 

NOTE 

Since the DCB's exist in the user area and 
are not protected, caution must be taken 
not to modify them in any way. 

IERR See Table 4-1 for error codes. For OPENs that are 
successful, the type of file is returned in IERR. 
For successful CREATs, the number of sectors is 
returned in IERR. Note that this is 1/2 the num- 
ber of blocks in the file. This number is only use- 
ful if the CREAT specified the rest of the disc (see 
CREAT) but is always returned. IERR is also 
returned in the A-Register. 

NAME is a six-character name array for or of the file. A 
legal file name is six ASCII characters in length. 
The first character must not be a blank or a num- 
ber. All characters must come from the set 13 thru 
•«- (see Appendix E) exclusive of special characters 
"+" (plus), "-" (minus), "," (comma), and ":" 
(colon). Imbedded blanks are not allowed. Short 
(less than 6 characters) names must be padded 
with trailing blanks. In the FORTRAN calling se- 
quence name must be converted from ASCII to 
octal and stored in the NAME array. Refer to the 
table in the RTE Manual for the ASCII to octal con- 
version. If FORTRAN IV is used, name can be 
written using Hollerith constants. Refer to the 
FORTRAN IV Manual. 

IBUF is the read/write array. This parameter defines 

the buffer address to/from which reads/writes are 
to take place. 
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OPTIONAL PARAMETERS 

Most of the subroutines have one or more optional param- 
eters. These parameters always appear at the end of the 
calling sequence. If it is desired to use an optional param- 
eter which is preceded by other optional parameters in the 
calling sequence, then all parameters up to the desired 
parameter must be supplied. In general, unsupplied 
optional parameters are assumed to be zero. 

The two most commonly used optional parameters are the 
cartridge label (ICR) and security code (ISECU). These 
are defined as follows: 

ISECU The security code can be ASCII or numeric char- 
acters, or a combination of both. The largest 
allowable number is 32767. When a code is not 
specified it defaults to zero. The security code 
parameter is given in the call must match the file's 
code when truncating, remaining, or purging the 
file. The security code parameter is defined as 
follows: 

ISECU < 0. File is protected and cannot be 

opened without the correct security 
code. 

ISECU = 0. File is not protected and can be 
read or changed by using any 
security code. 

ISECU > 0. File is write protected but can still 
be read without security code. 



The 2's complement of a positive 
code, as well as the positive code, 
will open the file for both read and 
write. 

ICR The ICR parameter has three meanings as shown 
below: 

ICR > 0. Directs file to the cartridge with the 

positive cartridge reference number 
(CR). CR is a numeric identifier 
assigned to all cartridges in the sys- 
tem. A listing of the cartridge 
directory (CL Operator Command) 
would reveal a number under the 
heading CR. This is the cartridge 
label and is directly associated with 
a logical unit number. 

ICR = 0. Directs file to all cartridges or, for 

CREATs, the first cartridge found 
with enough room. For OPEN, 
PURGE and NAMF calls, causes 
the first file found with the required 
name to be used. Note that car- 
tridges are searched in the order 
they appear in the disc directory. 
For more information on this order, 
refer to the DC Command in 
Section III. 

ICR < 0. Directs file to a disc logical unit 

number (e.g., ICR = -14 means 
logical unit number 14). 
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APOSN 

Purpose 

This routine sets the address of the next 
record for any file except type 0. 



EXT 



APOSN 





JSB 


APOSN 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


IREC 






DEF 


IRB 


Optional 




DEF 


IOFF 


Optional 


RTN 


return 


point 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code returned here. 


IREC 


DEC 


a 


Record number of next record. 


IRB 


DEC 


b 


Relative block address of next record. 


IOFF 


DEC 


c 


Block offset of next record. 



COMMENTS 



• If a type 1 or 2 file is being positioned, the optional 
IRB and IOFF parameters are not required. Actually, 
for type 1 or 2 files, APOSN is not needed (see 
READF, WRITF) for positioning. However, APOSN 
will function correctly to allow sequential access of 
any cartridge file from the specified record. 

• APOSN allows random access of sequential files. The 
parameters needed for APOSN are relative and are not 
affected by packing; they are obtained using a LOCF 
call. 

SEQUENCE OF OPERATIONS 

1 . If DCB is not open, reject call. 

2. Check if file type = 0. 



3. Check for enough parameters. 

4. If type 1 or 2, go to 7. 

5. Call subroutine LOCF to get the current IRB. 

6. Position to the new block; however, no file READS . 
a. May imply an extent change. 



b. Implies writing current block if written on, 
before positioning to a new block. 

7. Set current buffer pointer. 

8. If record number is less than 1 , error exit. 

9. Set record number. 
10. Return. 
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CLOSE 







Purpose 




This routine closes the DCB and makes the file available to 




other callers 


CLOSE also 


optionally truncates the file size. 




EXT 


CLOSE 






JSB 


CLOSE 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


ITRUN 




RTN 


return 


joint 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code returned here. 


ITRUN 


DEC 


n 


+M = number of blocks to be deleted 
from the end of the file when 
it is closed. 

-n = retain main file, delete extents. 

n = = standard close. 



COMMENTS 

• The following conditions must be met for the param- 
eter ITRUN to be recognized: 

a. The file must be opened exclusively. 

b. The current position must be in the main file 
(not an extent). 

c. Security codes must have matched at open. 

d. The file type must not be equal to zero. 

e. The number of blocks to be deleted must be less 
than or equal to the number of blocks in the file. 

NOTE 

If the number of blocks to be deleted 
equals the number of blocks in the file, 
then the file is purged. 



SEQUENCE OF OPERATIONS 



1. Check for enough parameters. 



2. If DCB is not open, reject call. 



3. If block currently in core was written on, write it to 
the file. 



Check file type, current extent, and security for 
truncate option. 



Call D.RTR to close the file (D.RTR makes the rest 
of the truncate checks). 



6. Return. 
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CREAT 











Purpose 


This routine closes the DCB (if open), 


and then creates the named file on the specified disc with the specified number of 


blocks. The file is lef 


t open 


exclusively 


to the caller on successful completion of the call. This call will not create a type file. 




EXT 




CREAT 






JSB 




CREAT 


Subroutine call 




DEF 




RTN 


Return address 




DEF 




IDCB 






DEF 




IERR 






DEF 




NAME 






DEF 




ISIZE 






DEF 




ITYPE 






DEF 




ISECU 


Optional 




DEF 




ICR 


Optional 


RTN 


return 


point 




Continue execution. 


IDCB 


BSS 




144 


144 word DCB buffer. 


IERR 


BSS 




1 


Error code— or number of sectors (twice the number of blocks) if CREAT successful. 


NAME 


ASC 




3, name 


File name. 


ISIZE 


DEC 




a 


Number of blocks in the file. If negative, use all of disc (see Comments). 




DEC 




b 


Record length (used for type 2 file only). 


ITYPE 


DEC 




c 


File type (see Comments). 


ISECU 


DEC 




d 


Security code. 


ICR 


DEC 




e 


Cartridge label. 



COMMENTS 

• The ISIZE parameter is a two-word integer array. The 
first word should contain the number of blocks desired 
in the file. If the number is negative, the rest of the disc 
will be used. Unused area may be returned with the 
CLOSE call, ITRUN parameter. The second word will be 
stored in the directory as the record size. It is used as 
the record size only if you are creating a type 2 file. 

• Since all type 2 files are addressed by record number, 
the maximum number of records allowed in a type 2 
file is limited to 32767. That is: 



number of blocks * 128 
record size 



must be < 32768 



• The ITYPE parameter refers to the file type and is 
defined as follows: 

1 — 1 28 word record length, random access. 

2 — user selected record length, random access. 

3 - (and greater) random record length, sequential access. 

4 — source program. 

5 - relocatable program. 

6 — RTE load module. 

7 - absolute program. 
> 7 - user defined. 



Note that the FMP will recognize only the above; however, 
the user may define any number of additional types. The 
FMP will treat these as type 3. 

• If type 3 or greater, an EOF mark is written at the 
beginning of the file. 

SEQUENCE OF OPERATIONS 

1 . Check for enough parameters. 

2. Close the DCB using CLOSE (ignore not open error). 

3. Check legality of NAME. 

4. Check legality of ITYPE. 

5. Check legality of ISIZE, and if ITYPE = 2, then check 
that no more than 32767 records will fit in allotted 
size. (This is to prevent the file from containing more 
records than possible to address.) If ITYPE = 1 , 
force record size to 128. 

6. Get a system track and write skeleton entry on the track. 

7. Schedule D.RTR to CREAT the file. 

8. Return the track. 

9. Check for D.RTR error; if any, exit. 
1 0. Open the file to the DCB . 

a. Read the directory entry to the DCB buffer area. 

b. Transfer directory parameters to the DCB. 

c. Set current position pointers in the DCB. 
If file type >3, set "written-on-flag" and EOF in DCB. 



11. 
12. 



Return. 
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FCONT 







Purpose 


This routine sends the standard RTE I/O Control request to type (non-disc) files. It has no effect on other files. 




EXT 


FCONT 






JSB 


FCONT 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


ICON1 






DEF 


ICON2 


Optional 


RTN 


return 


point 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code or file type returned here. 


ICON1 


OCT 


conwd 


See Control Word. 


ICON2 


DEC 


n 


Required for some functions (see Control Word). 



CONTROL WORD 

• The control word value {conwd) has one field that is 
ORed with the device logical unit number. 



15 



— i — r~ 

14 13 12 



— T — T" 

11 10 9 



— i — r - 

8 7 6 



L 



Function Code^ 



~ 1 1 - 

5 4 3 



— i — r- 

2 1 



■ Not Used 



Function Code 




(Octal) 


Action 


00 


Unused 


01 


Write end-of-file (mag tape) 


02 


Backspace one record (mag tape) 


03 


Forward space one record (mag tape) 


04 


Rewind (mag tape) 


05 


Rewind standby (mag tape) 


06 


Dynamic status (mag tape) 


07 


Set end-of-paper tape 


10 


Generate paper tape leader 


11 


List output line spacing 


12 


Write gap (mag tape) 


13 


Forward space file (mag tape) 


14 


Backward space file (mag tape) 



• The following functions are defined for DVR00, 
DVR01andDVR02: 

20 Enable terminal— allows terminal to schedule its 
program when any key is struck. 



2 1 Disable terminal-inhibits scheduling of terminal's 
program. 

22 Set time out— the optional third parameter is set 
as the new time out interval. 

23 Ignore all further action requests until: 

a) The Queue is empty 

b) An input request is received 

c) A restore control request is received. 

24 Restore output processing (this request is usually 
not needed). 

• Function Code 1 1 8 (list output line spacing), requires 
the optional parameter ICON2. ICON2 must designate 
the number of lines to be spaced on the specified logical 
unit. A negative parameter specifies a page eject on a 
line printer. For details of line printer formatting 
consult Appendix F in the RTE Manual. 

SEQUENCE OF OPERATION 

1 . If DCB is not open, reject call. 

2. Check if file type = 0. 

3. Issue control EXEC call. 

4. Return. 
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RTN 



ISTAT 



FSTAT 



Purpose 



This routine returns information on all cartridge 
labels in the system. 



EXT 



FSTAT 



JSB FSTAT 

DEF RTN 

DEF ISTAT 

return point 



BSS 



125 



Subroutine call 
Return address 

Continue execution. 
Buffer of 125 words. 



COMMENTS 

• The cartridge status is contained in four word 
increments. 

Word Meaning 

Logical unit number (first disc). 

1 Last track for FMP. 

2 Cartridge label. 

3 Locking program's ID segment address, 
or if not locked. 

4 Logical unit number (second disc). 

124 

NOTE 
This list is terminated with a zero. 
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FMP 



LOCF 

Purpose 
This routine formats and returns location and status information from the DCB. 



EXT 



LOCF 





JSB 


LOCF 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


IREC 






DEF 


IRB 


Optional 




DEF 


IOFF 


Optional 




DEF 


JSEC 


Optional 




DEF 


JLU 


Optional 




DEF 


JTY 


Optional 




DEF 


JREC 


Optional 


RTN 


return 


point 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 




Error code returned here. 


IREC 


BSS 




Next record number. 


IRB 


BSS 




Relative block of next read. 


IOFF 


BSS 




Block offset of next record. 


JSEC 


BSS 




Number of sectors in the file. 


JLU 


BSS 




File logical unit. 


JTY 


BSS 




File type. 


JREC 


BSS 




Record size. 



See Comments 



COMMENTS 

• A further elaboration on the parameters follows: 

IREC is the number of the next record. 

IRB is the relative block of the next record (same 
as IREC for type 1 files). IRB is not set for a 
type file. 

NOTE 

IRB includes extend information (i.e., 
IRB = JSEC/2*Extent number plus 
relative block in current extent). 

IOFF is the block offset of the next record (0 for 

type 1 files). IRB and IOFF need not be coded 
for type 1 files, or for the LOCF call if the in- 
formation is not required. For files other than 
type 1 and (IOFF not set for type file), 
IOFF will be constrained as follows: 

< IOFF < 128 

JSEC is the number of sectors in the main file. 
JSEC is not set for type file. 

JLU is the logical unit the file is on (disc or 
non-disc). 



JTY is the file type as set in DCB (will be 1 if file 
was forced to type 1 at open). 

JREC is the record size word. This will be as it is in 
the directory entry except for type 1 (actual or 
forced) files, in which case it is set to 128 on 
the first read/write access. If file is type 0, 
then JREC will be the read/write code. 
Bit 15 = 1 implies read legal; bit = 1 implies 
write legal. 

SEQUENCE OF OPERATIONS 

1 . Check for enough parameters. 

2. Fetch DCB. 

3. Check that file is open. 

4. Set IREC. 

5. If type 0. go to 8. 

6. If type 1 or 2, compute current address from the 
record number. 

7. Compute and set IOFF, IRB, JSEC. 

8. Set JTY, JLU, JREC. 

9. Return. 
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NAMF 









Purpose 


This routine closes the DCB (if 


open) and then renames the specified file. 




EXT 


NAMF 






JSB 


NAMF 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


NAME 






DEF 


NNAME 






DEF 


ISECU 


Optional 




DEF 


ICR 


Optional 


RTN 


return point 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code returned here. 


NAME 


ASC 


3, name 


File's present name. 


NNAME 


ASC 


3, nuname File's new name. 


ISECU 


DEC 


a 


Security code. 


ICR 


DEC 


b 


Cartridge label. 



COMMENTS 

• The file specified by name must not be open when this 
call is made. If name is a non-zero security, the proper 
security code must be included. If ICR is furnished, 
only that cartridge is searched for name; otherwise, all 
mounted cartridges are searched. In the case where all 
cartridges are searched, only the first file found with the 
given name will be changed. 

• nuname is the new name of the same file. 
SEQUENCE OF OPERATIONS 

1 . Check for enough parameters. 

2. Check legality of nuname. 

3. Call OPEN to open the file exclusively. 



4. If OPEN errors, exit. 

5 . Check file security flag in DCB ; if mismatch, close 
and exit. 

6. Get a system track. 

7. Write new name on track. 

8. Pass track to D.RTR; rename request. 

9. Return system track. 

10. Close the DCB. 

1 1 . Check for D.RTR errors. 

12. Return. 
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FMP 



OPEN 







Purpose 




This routine closes the DCB (if open), 


and then opens the named file. 




EXT 


OPEN 






JSB 


OPEN 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


NAME 






DEF 


IOPTN 


Optional 




DEF 


ISECU 


Optional 




DEF 


ICR 


Optional 


RTN 


return 


point 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code, or file type if OPEN successful. 


NAME 


ASC 


3, name 


File name. 


IOPTN 


OCT 


a 


Open options (see Comments). 


ISECU 


DEC 


b 


Security code. 


ICR 


DEC 


c 


Cartridge label. 



COMMENTS 

• The IOPTN (open option) parameter is defined as 
follows: 



F = uses function code defined in directory. 

F = 1 uses function code defined in bits 6-10 of this 
word for type file only. 



15 


I I 

14 13 12 


I I 

11 10 9 


I I 

8 7 6 


I I 
5 4 3 


I I 
2 1 


The following code 
type is 0. 




00000XAKVM00FTUE 


M = for ASCII. 


\* 


'here 










M = 1 for binary. 



E = for exclusive open. 

E = 1 for non-exclusive open. 

U = for non-update open. 

U = 1 for update open. 

T = means file type defined in directory. 

T = 1 means force to file type 1 (extents are not 
addressable). 



V = 1 , and M = 1 , causes the length of punched tape 

input to be determined by the word count in the 
first non-zero character read from the tape. 

V = 0, and M = 1, the length of the punched tape 

input is determined by the buffer length specified 
in the call. 

M determines the mode of the data transfer (if 
applicable). 

K = 1 causes keyboard input to be printed as received. 
If K = input from the keyboard is not printed. 
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A = 1 designates punching ASCII characters on the 
teleprinter (M = 0). ASCII is usually printed; but 
since it is sometimes desirable to punch ASCII 
tapes, this option is provided. (If A = 0, M 
determines mode of transfer.) 

X = When paper tape devices are used, "X," in combina- 
tion with "M" and "V" will indicate an honesty 
mode. 

On input, if "X," "M," and "V" are set, absolute 
binary tape format is expected and handled. If 
"X" and "M" are set, and "V" is not, leader is not 
skipped and the specified number of words are 
read. On output, the record terminator (usually 
four feed frames) is not punched. 

On input, if "X" is set and "M" is not, ASCII tape 
format is expected. Leader is not skipped, bit 8 is 
stripped, but otherwise, all characters are passed to 
the user's buffer. The only exception is line-feed, 
which terminates the record. On output, carriage 
return and line-feed are suppressed; any trailing 
left arrow is not (i.e., left arrow is transmitted but 
carriage return/line feed is not). 

UPDATE OPEN . Update implies that a block is read 
before it is modified so that existing records within the 
block will not be destroyed. Type 1 files are inherently 
update files. In type 1 and 2 files the end-of-file is the 
last word of the last block in the file. However, in other 
type files it is a special word (- 1) for the length of a rec- 
ord. In order to preserve data in a type 2 file, it should 
be opened for update whenever any non-sequential 
accesses are to be performed, and the file is to be modi- 
fied. That is to say, a type 2 file should be modified in 
non-update mode only when originally writing the file, 
or adding to the end of the file; and then only if it is to 
be written sequentially. Update/non-update has no 
effect on reading or positioning. 

In type 3 and above files, an end-of-file mark is written 
after each record that is written in the non-update mode. 
In either mode (update/non-update), records written be- 
yond an end-of-file are written in non-update fashion. 
That is, replace the end-of-file with the new record, 
followed by an end-of-file. 



• EXCLUSIVE OPEN. In order to prevent two or more 
programs from destructively interfering with each other, 
a file may be opened either exclusively or non-exclusively. 
An exclusive open is granted only to one program at a 
time. If the call is rejected because another program has 
the file open, you must make the call again; it is not 
stacked by the FMP. 

• NON-EXCLUSIVE OPEN . A non-exclusive open may be 
granted to as many as seven programs per file at one time. 
A non-exclusive open will not be granted if the file is al- 
ready opened exclusively. Each time an open is requested 
for a file, all programs currently having that file open will 
be checked. If a program is dormant (i.e., its point of sus- 
pension is zero), the file will be closed to that program. 
This type of close will not post the packing buffer nor 
will it close the DCB. This type of close is required in 
case of a program being aborted or otherwise terminating 
without closing a file. Any open flag will also be cleared 
if it does not point to a valid ID segment. (Possible if 
the file was left open on a different system.) 

SEQUENCE OF OPERATIONS 

1 . Check for enough parameters. 

2. Close the DCB using CLOSE (ignore not open error). 

3. Format and issue D.RTR request. 

4. Call RMPAR to get D.RTR return parameters. 

5. If D.RTR error, exit. 

6. Open the file to the DCB. 

a. Read the directory entry for the file into 
the DCB buffer area. 

b. Transfer directory parameters to the DCB. 

c. Set current position pointers in the DCB. 

7. If OPEN protected (i.e., security code < 0), and 
security code mismatches, close the file and exit. 

8. If type = and subfunction option present, (Bit 3 = 1), 
replace subfunction. 

9. Return. 
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FMP 



POSNT 









Purpose 


This routine 


causes the next read or write to access the given record in any file type. 




EXT 


POSTN 






JSB 


POSNT 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


NUR 






DEF 


IR 


Optional 


RTN 


return 


point 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code returned here. 


NUR 


DEC 


a 


New record number. 


IR 


DEC 


b 


Absolute vs. relative control parameter for NUR. 



COMMENTS 

• The NUR (new record) parameter is defined as follows: 

NUR > Forward positioning, skip NUR records. 
NUR < Backward positioning, skip NUR records. 
NUR = No operation. 

NOTE 

If a type file is involved the motion re- 
quested must be legal for the device. 

• The IR (absolute vs relative) parameter is defined as 
follows: 

IR = The new record indicated by NUR is 

or relative to the present position in the 

nor present file. 

IR f The new record indicated by NUR is 

the absolute number starting from the 
first record in the file (record num- 
ber 1). Note that NUR must be > 0. 



• Forward positioning on a type file is accomplished by 
reading records until one less than the desired record is 
read, or an EOF is read. In all cases, EOF terminates 
positioning. 

• Backspacing on type files can be accomplished three 
ways. Briefly, if the first record backspaced over is an 
EOF, and the only EOF, no error occurs. If an EOF is 
encountered anywhere else (i.e., as a subsequent record), 
a -12 error will occur, and the call will be terminated 
after forward spacing to position the file immediately 
following the EOF. 

Examples (refer to Figure 2-1): 

1 . File position is immediately after EOF2 and NUR 
indicates backspace four records. Final file ends up 
immediately after EOF1 with no error. 

2. File position is at 2A and NUR indicates backspace 
five records. Error -12 results, the file position ends 
up immediately after EOF2, and the call is 
terminated. 
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3. File position is immediately after EOF2 and NUR 
indicates backspace five records. Error -12 results, 
the file position ends up immediately after EOF1 , 
and the call is terminated. 



EOF1 
--HI— 



1A 



IB 



EOF2 

HI— 



2A 



2B 



Figure 2-1. Record Positioning Example Using 
NUR in POSNT 



• Type 3 and above files are treated as mag tape files. To 
be correct, a backspace should be issued after an EOF is 
read, and before continuing to write. This action simu- 
lates a magnetic tape, that is, the EOF is spaced over. It 
is also legal to continue without backspacing. 

SEQUENCE OF OPERATIONS 

1 . Check for enough parameters. 

2. Set reading flag. 

3. If DCB is not open, reject call. 

4. Compute the relative record number. 

5. If type 0, go to 17. 

6. If type 1 or 2, go to 14. 

7. If forward spacing, call READF to read the required 
number of records (unless EOF or error). 



8. If current position is EOF and EOF read bit is set, 
clear it and go to 9; else 10. 

9. Decrement record number and backspace count; if 
done, exit. 

10. Backspace one word and read it. 

1 1 . Backspace over the record. 

1 2. Read length; if no match, error exit. 

13. Go to 9. 

14. Compute absolute record count; if less than 1 , error 
exit. 

15. Set record number. 

16. Return. 

17. If forward space, go to 7. 

1 8 . Check backspace legal flag. 

19. Backspace-EXEC call. 

20. If EOF encountered and not first backspace, go to 7 
with 1 record (READF will return EOF). 

21. If not done, go to 19. 

22. Return. 
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FMP 



PURGE 









Purpose 




This routine closes the DCB (if open) 


and then deletes the named file and all of its extents. 




EXT 




PURGE 






JSB 




PURGE 


Subroutine call 




DEF 




RTN 


Return address 




DEF 




IDCB 






DEF 




IERR 






DEF 




NAME 






DEF 




ISECU 


Optional 




DEF 




ICR 


Optional 


RTN 


return 


point 




Continue execution. 


IDCB 


BSS 




144 


144 word DCB buffer. 


IERR 


BSS 




1 


Error code returned here. 


NAME 


ASC 




3, name 


File name. 


ISECU 


DEC 




a 


Security code. 


ICR 


DEC 




b 


Cartridge label. 



COMMENTS 

• The file must not be open to any other program when 
this call is made. 

• This routine will not purge type (non-disc) files. 

• If the file being purged is the last file on the disc (exclud- 
ing a type 6 file), all area from the last unpurged or 
type 6 file up to and including the purged file, is returned 
to the system. If a purged file is not the last file, then its 
area may be recovered only by packing, or by purging all 
files after it in the directory. Type 6 file area may only 
be recovered by packing. 



SEQUENCE OF OPERATIONS 

1. Check for enough parameters. 

2. Call OPEN to open the file exclusively. 

3. If OPEN errors, exit 

4. Check security flag in DCB; if mismatch, close and exit. 

5. Close and truncate file to zero length. 

6. Return. 
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READF 









Purpose 


This routine reads a 


record from the file currently open to the DCB, to the user buffer. 




EXT 


READF 






JSB 


READF 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 






DEF 


IBUF 






DEF 


IL 


Optional 




DEF 


LEN 


Optional 




DEF 


NUM 


Optional 


RTN 


return point 


Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code returned here. 


IBUF 


BSS 


IL 


Data buffer. 


IL 


DEC 


a 


Read request length (see Comments). 


LEN 


BSS 


b 


Actual read length returned here (see Comments). 


NUM 


DEC 


c 


Record number to be read (see Comments). 



COMMENTS 

• The IL (request length) parameter takes on different 
meanings depending on the file-type . Refer to Table 2-2. 

• The LEN (actual length) parameter provides the actual 
number of words transferred to IBUF. LEN can never 
exceed IL; therefore, if LEN = IL the record may have 
been too long (unless a type 1 file is being read). If 
LEN =-i, then an end-of-file has been read. 

• NUM is the random access record number and is used 
only when the file type is 1 or 2. Record number 1 is 
the first record in a file. If NUM = or is absent, then 
the transfer starts at the current record number. If NUM 
is positive, then the transfer starts at the record number 
indicated by NUM. If NUM is negative, then the transfer 
starts at the current record plus NUM. Therefore: 

File Type Meaning 

Not used. 

1 NUM defines the first record transferred, and 
IL defines the number of records through 
the length in words. 

2 NUM defines the record to be transferred. 
3 and above Not used. 



Examples (refer to Figure 2-2): 

1 . If NUM = 0, transfer starts at record number 5. 

2. If NUM = 6, transfer starts at record number 6 
(same as NUM). 

3. If NUM = -3, transfer starts at record number 2 
(5 + (-3) = 2). 



Start End 

Of Of 

File File 

(SOF) 12 3 4 5 6 7 8 (EOF) 



— Ih 



You are here 



Figure 2-2. Record Positioning Example Using 
NUM in READF 
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Table 2-2. Read Request File Length (IL) vs. File Types 



N. Request 
NJ-ength 
File N. 
Type N^ 


IL>0 


IL = 

(Indicates zero length record) 

(Not recommended) 


IL not supplied 





The routine will transfer up to 
IL words. If the record length 
is smaller than IL, only the 
record is transferred. If the 
record is the same size, 
smaller, or larger than IL, no 
error is indicated. 


A zero length record is passed 
to the device; usually causes 
a record to be skipped and the 
record is counted. 


A zero length record is 
passed to the device; 
usually causes a record to 
be skipped and the record 
is counted. 
(Not recommended) 


1 


The routine reads exactly IL 
words. Therefore, since the 
record length is fixed at 1 28 
words, less than a full record 
or more than one record may 
be transferred. All of IL, 
however, must be within the 
file. 


A zero length read from the 
disc is done, which results in 
no position change; the record 
is not counted. 


128-word record is 
assumed. 


>1 


The routine will transfer up 
to IL words. If the record 
length is smaller than IL, only 
the record is transferred. If 
the record is the same size, 
smaller or larger than IL, no 
error is indicated. 


Causes a record to be skipped 
and the record is counted. 


Actual record length is 
used. 



• There are three levels of EOF associated with file types 
that are defined below. 

File Type Meaning 

When an EOF is read, parameter LEN is set 

to - 1 with no error. Accesses may continue 
beyond the EOF. 

1 and 2 When an EOF is read, parameter IERR is set 
to -12 indicating an error condition. No 
accesses beyond the EOF. 

3 and The first EOF read causes parameter LEN to 

above be set to -1 with no error. A read access 

beyond this EOF will cause an error condition 
(IERR = -1 2). A write access may continue 
beyond this EOF with no error. 
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SEQUENCE OF OPERATIONS 

1 . Set read flag and fetch parameters. 

2. Check for enough parameters. 

3. If DCB is not open, reject call. 

4. If read or update, set reading flag. 

5 . If type 1 , force DCB length to 1 28. 

6. If type 1 or 2, do random access positioning (implies 
EOF if initial position not in file). If new position 
not in currently resident block, then write the block 
if it was written on. 

7. If type 2 or above, and reading flag set, and DCB 
buffer is empty, then read a block to DCB. 

8. If type less than 3, skip to 18. 

9. If current position is at EOF set EOF encountered 
flag in DCB. If already set, set IERR = -12 and exit; 
else step record count, set LEN = -1, and exit. 

10. Read the record length. 

11. If IL too short, set skip count. 

12. Read the record. 

13. If skip count set, skip the rest of the record. 

14. If type 2, set record count and exit. 



1 5 . Read the length word. 

16. If lengths do not match, take error exit. 

17. If reading flag not set , set EOF in buffer , set written 
on flag, step record count and exit; else step record 
count and exit. 

18. If type 2, go to 11. 

19. If type 0, go to 30. 

20. If type 1 , round up length to even 1 28 words and 
save as increment in record count. 

2 1 . Check if request is within the file. 

22. If track switch, compute maximum words this accesss. 

23. Read the record. 

24. If type read, do EOF test and return. 

25 . If type 1 , check for disc errors. 

26. Update for rest of record. 

27. If more to transfer, go to 22. 

28. Update record count. 

29. Return. 

30. Test read legality bits. 

31. Go to 23. 
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FMP 



RWNDF 







Purpose 






This routine rewinds type files, 


and sets disc files so that 




the next record is the first record 


in the file. 




EXT 


RWNDF 






JSB 


RWNDF 


Subroutine call 




DEF 


RTN 


Return address 




DEF 


IDCB 






DEF 


IERR 


Optional 


RTN 


return point 




Continue execution. 


IDCB 


BSS 


144 


144 word DCB buffer. 


IERR 


BSS 


1 


Error code returned here. 



SEQUENCE OF OPERATIONS 

1 . If DCB is not open, reject call. 

2. If type file, do EXEC rewind request and return. 

3. Write out current block if written on. 



4. If not in main file, call D.RTR to get the main file 
address. 

5. Reset current position pointers in DCB to beginning 
of file. 
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WRITF 

Purpose 
This routine writes a record on the file currently open to the DCB. 
EXT WRITF 



JSB 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 



WRITF 

RTN 

IDCB 

IERR 

IBUF 

IL 

NUM 



Subroutine call 
Return address 



RTN 



IDCB 
IERR 
IBUF 
IL 

NUM 



return point 



BSS 
BSS 
BSS 
DEC 
DEC 



144 

1 

IL 

a 
b 



Continue execution. 

144 word DCB buffer. 

Error code returned here. 

Data buffer. 

Write request length (see Comments). 

Record number to be written (see Comments). 



COMMENTS 

• The IL (write request length) parameter takes on different 
meanings depending on the file type. Refer to Table 2-3. 

• NUM is the random access record number and is used 
only when the file type is 1 or 2. Record number 1 is 
the first record in a file.) If NUM = or is absent, then 
the transfer starts at the current record number. If NUM 
is positive, then the transfer starts at the record number 
indicated by NUM. If NUM is negative, then the transfer 
starts at the current record plus NUM. Therefore: 



File Type 

Not used. 



Action 



Examples (refer to Figure 2-3): 

1. If NUM = 0, transfer starts at record number 5. 

2. If NUM = 6, transfer starts at record number 6 
(same as NUM). 

3. If NUM = -3, transfer starts at record number 2 
(5 + (-3) = 2). 



Start End 

Of Of 

File File 

(SOF) 12 3 4 5 6 7 8 (EOF) 



1 NUM defines the first record to be written, 
and IL defines the number of records 
through the length in words. 

2 NUM defines the record to be transferred. 
3 and above Not used. 



You are here 



Figure 2-3. Record Positioning Example Using 
NUM in WRITF 
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Table 2-3. Write Request File Length (IL) vs. File Type 




>v Request 
>v Length 

File X. 
Type \ 


IL>0 


IL=0 


IL = -1 


IL<-1 

(Not 
(recommended) 


IL not supplied 





The routine will write 
exactly IL words. 


A zero length 
record is 
written. 


An end-of-file 
is written. 


The length (IL) 
is interpreted 
as a character 
count. 


A zero length rec- 
ord is written. 


1 


Data is written in 128 
word blocks. For ex- 
ample, IL is rounded up 
to 128(1 block) if IL is 
between 1 and 127. IL 
is rounded up to 256 
(2 blocks) if IL= 129 
to 255. 


No action. 


No action. 


No action. 


128 is used. 


2 


IL is ignored and the 
file defined record 
length is used. 


IL is ignored 
and the file 
defined record 
length is used. 


No action. 


No action. 


The file defined 
record length 
is used. 


>2 


The routine will write 
exactly IL words. 


A zero length 
record is 
written. 


An end-of- 
file is 
written. 


Undefined. 


A zero length 
record is 
written. 



SEQUENCE OF OPERATIONS 

1 . Set write flag and fetch parameters. 

2. Check for enough parameters. 

3. If DCB is not open, reject call. 

4. Check security. 

5. If update, set reading flag. 

6. If type 1 , force DCB length to 1 28. 

7. If type 1 or 2 and EOF write, then exit, else do ran- 
dom access positioning (implies EOF if initial position 
not in file). If new position not in currently resident 
block, then write the block if it was written on. 

8. If type 2 or above, and reading flag set and DCB buf- 
fer is empty, then read a block to DCB. 

9. If type less than 3, skip to 19. 



10. If current position is at EOF, then clear reading flag. 

11. If EOF write: (a) then set EOF in buffer, (b) set 
written on flag, (c) step record count, and (d) exit. 

12. If reading, then this is an update write; check lengths 
(must match), 

13. Write the record length. 

14. Write the record. 

15. If skip count set, skip the rest of the record. 

16. If type 2, then go to lie. 

17. Write the length word. 

18. If reading flag not set, go to 11a; else 1 lc. 

19. If type 2, go to 14. 

20. Iftype0,goto31. 
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21. If type 2, round up length to even 1 28 words and save 
as increment in record count. 

22. Check if request within file. 

23. If write, use round-up length. 

24. If track switch, compute maximum words this access. 

25. Write the record. 

26. If type 1 , check for disc errors. 

27. Update for rest of record. 

28. If more to transfer, go to 24. 

29. Update record count. 

30. Return. 

31. Test write legality bits. 

32. If EOF write, make control request and return. 

33. Go to 25. 
EXAMPLE PROGRAM 

The following listings show a sample program (DEMOl) and 
subroutine (IERR). The program is designed to sort a file 
and place the results in another file using most of the calls 
described in this section. Subroutine IERR is called by 
the program to check if any errors were detected. 

Operation is simple and straightforward. Most of the 
instructions are "commented" on the first page of the 
program. Proceed as follows: 

a. Generate the code on tape or cards, or enter the 
code directly into a file with the Store Command. 

:ST, 1,DEM01S:::4:24 
Use Control D for end-of-file. 



b. Submit a file to be sorted and call it USERFx 
where x is a number from 0-9. 

: ST, rami, USERF* 



c. Create a file that is the target file for the sorted data, 
and is called USERFy where y is a number from 
0-9. One suggestion is to create a type file 
referencing the line printer (list device = LUG). 

:CR,USERF.y,6,WR 



d. Move the program into the RTE system and 
compile it with the FORTRAN Compiler. Once 
its compiled save the binary code in a file for 
future use. 

e. Put the program into the system with the RTE 
loader. 

f. Turn the program on with the required parameters. 
*ON,DEM01,x,.y ) z 

where 

USER* is the file to be sorted (only x is required). 

USERy is the target file (on\yy is required). 

z is the key word to be sorted on. For example, if 
the file to be sorted consisted of a group of names, 
z could be 1 indicating sort on the first two letters 
of the name. 
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DEM01S T=00004 IS ON CR00100 USING 00024 BLKS R=0000 

0001 FTN,L 

PROGRAM DEMO1(3>90> 

THE PURPOSE OF THIS PROGRAM IS TO SORT A FILE CALLED 
USERFX AND PLACE THE RESULTING DATA IN FILE USERFY. 

THE SORT WILL BE KEYED ON WORD POSITION Z. 

X,Y AND Z ARE THE THREE TURN ON PARAMETERS. 

A THIRD FILE (USERFA) IS CREATED BY THIS PROGRAM AND 
THEN PURGED AT TERMINATION. THIS FILE WILL BE 
TYPE 2 WITH 4 WORD RECORDS. 

METHOD UF APPROACH: 

1. USERFX WILL BE READ AND THE ADDRESS OF EACH 
OF ITS RECORDS ALONG WITH THE KEY WORD (WORD Z ) 
WILL BE SAVED IN USERFA. 

2. USERFA WILL BE SORTED ON THE KEY WORD USING A 
"BUBBLE SORT". 

3. THE ADDRESSES SAVED IN USERFA WILL THEN BE READ 
SEQUENTIALLY AND USED TO ADDRESS THE MATCHING 
RECORD IN USERFX. THIS RECORD WILL THEN 
BE READ AND WRITTEN ON USERFY. 

DIMENSION IUSRXU44), IUSRYM44), IUSRA( 144), IBUFC 1 28 ),NUSRC4 > 
DIMENSION IADRSC4) 

SET UP THE FILE NAME ARRAYS 

DATA NUSR/2HUS,2HER, 0/, IR/43060B/S IUA/2HFA/ 

GET THE PRAMETERS AND SET UP DEFAULTS AS FOLLOWS: 

USERFX DEFAULT IS USERF0 
USERFY DEFAULT IS USERF1 
Z DEFAULT IS 2 

CALL RMPAR(IUSRX) 

IUX=IR+IUSRX(1 ) 

IUY=IR+IUSRX(2) 

IWORD=IUSRX(3) 

IFCIUY-IR520, 10/20 

IUY=IUY+1 

IF( IWORD)40, 30,40 

IW0RD=2 

OPEN THE USER FILES AND CREAT THE TEMP FILE. 

NUSR(3)=IUX 

CALL OPENCIUSRX, IER,NUSR, 1 ) 

NON-EXCLUSIVE OPEN FOR X SO OTHERS CAN READ IT TOO. 
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0002 




000 3 


C 


0004 


c 


0005 


c 


0006 


c 


0007 


c 


0008 


c 


0009 


c 


0010 


c 


00 1 1 


c 


0012 


c 


0013 


c 


0014 


c 


0015 


c 


0016 


c 


0017 


c 


001 8 


c 


0019 


c 


00 20 


c 


0021 


c 


0022 


c 


0023 


c 


0024 


c 


0025 


c 


0026 


c 


0027 


c 


0028 


c 


0029 


c 


0030 




0031 




0032 


c 


0033 


c 


00 34 


c 


0035 




0036 


c 


0037 


c 


0038 


c 


00 39 


c 


0040 


c 


0041 


c 


0042 


c 


0043 




0044 




0045 




0046 




0047 




0048 


10 


0049 


20 


0050 


30 


0051 


c 


0052 


c 


0053 


c 


0054 


40 


0055 


50 


0056 


c 


0057 


c 


0058 


c 
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0059 IFC IERRC IER, IUX) )50, 60 

0060 C 

0061 C NOW AN EXCLUSIVE OPEN OF Y 

0062 C 

0063 60 NUSRC3)=IUY 

0064 70 CALL OPEN( IUSRY, IER,NUSR) 

0065 C 

0066 C CHECK FOR ERRORS 
00 67 C 

0068 IFC IERRC IER, IUY))70,75 

0069 C 

0070 C SET UP SIZE ARRAY FOR CREAT 100 BLOCKS, 4 WORD RECORDS 

0071 C 

0072 75 IBUF(1)=100 

0073 IBUFC2)=4 

0074 C 

0075 C CREAT USERFA 

0076 C 

0077 NUSR(3)=IUA 

0078 80 CALL CREATCIUSRA, IER,NUSR> IBUF,2) 

0079 IF( IERRC IER, IUA) )80,90 

0080 C 

0081 C ALL FILES ARE NOW OPEN 

0082 C 

0083 C PHASE ONE BEGIN. 

0084 C 

0085 C SET NUMBER OF RECORDS IN FILE TO 

0086 C 

0087 90 NOREC=0 

0088 C 

0089 C FOURCE SHORT RECORDS TO TOP (I.E. DEFAULT IS A ZERO) 

0090 C 

0091 100 IBUFC IWORD)=0 

0092 C 

0093 C GET CURRENT POSITION 

00 94 C 

0095 CALL LOCF( IUSRX, IER, IADRSC2).. IADRSC3), IADRSC4) ) 

0096 CALL IERRC IER, IUX) 

0097 C 

0098 C READ THE RECORD AND SET THE KEY 

0099 C 

0100 CALL READFCIUSRX, IER, IBUF, I WORD, L) 

0101 CALL IERRC IER, IUX) 

0102 IADRSC1 )=IBUFC IWORD) 

0103 C 

0104 C IF EOF THEN GO TO PHASE TWO. 

0105 C 

0106 IFCL)200>120 

0107 C 

0108 C WRITE USERFA ENTRY 

0109 C 

0110 120 CALL WRITFCIUSRA, IER, IADRS) 

0111 CALL IERRC IER, IUA) 

0112 C 

0113 C STEP THE RECORD COUNT AND GO READ THE NEXT RECORD 

01 14 C 

0115 NOREC=NOREC+l 

01 16 GO TO 100 
01 17 C 

01 18 C 
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0119 C BEGIN PHASE TWO - BUBBLE SORT OF USERFA ON 

0120 C THE FIRST WORD (I.E. THE KEY WORD) 

0121 C 

0122 C FIRST RE OPEN USERFA AND SET FOR UPDATE. 

0123 C 

0124 200 CALL OPENCIUSRA, IER,NUSR,2) 

0125 CALL IERRC IER, IUA) 

0126 C 

0127 C SORT INITIALIZE. IBUF WILL CONTAIN 

0128 C THE TWO RECORDS TO BE TESTED. 

0129 C ICUR WILL POINT AT THE CURRENT WINNER AND 

0130 C I TEST WILL POINT AT THE TEST RECORD. 

0131 C 

0132 ICUR=1 

0133 ITEST=5 

0134 C 

0135 C ISWCO WILL BE SET NON ZERO WHENEVER A RECORD IS SWAPPED. 

0136 C 

0137 C START THE SORT 

0138 C 

0139 DO 295 K=2>N0REC 

0140 C 

0141 C LAST WILL CONTAIN THE NUMBER OF THE LAST RECORD FOR 

0142 C THE CURRENT PASS. 

0143 C 

0144 LAST=N0REC-K+2 

0145 ISWCO=0 

0146 C 

0147 C READ THE CURRENT RECORD FOR THIS PASS 

0148 C 

0149 CALL READFCIUSRA, IER, IBUF( ICUR ) , 4, L, K- 1 ) 

0150 CALL IERRC IER, IUA) 

0151 C 

0152 C START SINK SECTION 

0153 C 

0154 205 DO 250 I=K,LAST 

0155 C 

0156 C READ THE CURRENT TEST RECORD 

0157 C 

0158 CALL READFC IUSRA, IER, I BUF ( ITEST),4>L* I ) 

0159 CALL IERRC IERj IUA) 

0160 C 

0161 C TEST THE FIRST WORD AGAINST CURRENT WINNER. 

0162 C 

0163 IFC IBUFCITEST)-IBUF( I CUR ) )225, 21 0, 2 1 

0164 C 

0165 C ORDER O-K SET NEW WINNER. 

0166 C 

0167 210 J=ITEST 

0168 ITEST=ICUR 

0169 ICUR=J 

0170 GO TO 250 

0171 C 

0172 C OUT OF ORDER - SWAP THE RECORDS 

0173 C TEST TO CURRENT RECORD LESS ONE , CURRENT WINNER TO CURRENT 

0174 C RECORD POSITION 

0175 C 

0176 225 CALL WRI TFC I USRA, IER, I BUFC ITEST ) , 4, I - 1 ) 

0177 CALL IERRC IER, IUA) 

0178 C 
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0179 

0180 

0181 

0182 

0183 

0184 

0185 

0186 

0187 

0188 

0189 

0190 

0191 

0192 

0193 

0194 

0195 

0196 

0197 

0198 

0199 

0200 

0201 

0202 

0203 

0204 

020 5 

0206 

0207 

020 8 

0209 

0210 

0211 

0212 

0213 

0214 

0215 

0216 

0217 

0218 

0219 

0220 

0221 

0222 

0223 

0224 

0225 

0226 

0227 

0228 

0229 

0230 

0231 

0232 

0233 

0234 

0235 

0236 

0237 

0238 



250 



C 
C 
C 
C 
C 

C 
C 

c 



255 



C 
C 

c 

c 
c 
c 
c 



c 
c 
c 

c 
c 
c 



260 



280 



C 
C 
C 
C 



C 
C 

c 



290 



C 
C 
C 



NOW THE CURRENT. NOTE WE CAN USE A SEQUENTIAL WRITE HERE 

CALL WRITFCIUSRA, IER, IBUF(ICUR)) 
CALL IERRC IER> IUA) 

SET THE SWAPPED FLAG 

ISWCO=-l 
CONTINUE 

END OF SINK SECTION 

IS FILE ORDERED?? 

IF(ISWCO)255,300 

NO. NOW DO THE FLOAT SECTION 

ISWCO=0 

DO 290 I=K,LAST 

FLOAT SECTION GOES UP THE LIST SO IREC MUST BE COMPUTED 
IREC=LAST-I+K-1 

IREC IS THE CURRENT RECORD ADDRESS 
READ A RECORD 

CALL READFC IUSRA, IER, IBUF( I TEST ), 4, L, IREC) 
CALL IERRC IER, IUA) 

ITEST THE RECORD AGAINST THE CURRENT WINNER 

IFC IBUF( ITEST)-IBUF(ICUR) )260> 260,280 

ORDERED SO SET NEW WINNER. 

J=ITEST 
ITEST=ICUR 
ICUR=J 
GO TO 290 

NOT ORDERED SO SWAP THE RECORDS 

CALL WRITFC IUSRA, IER, IBUF( ICUR),4, IREC) 
CALL IERR( IER, IUA) 

HERE AGAIN BY CHOSING THE ORDER WE CAN USE A SEQUENTIAL 
WRITE 

CALL WRITF( IUSRA, IER, IBUF( ITEST) ) 
CALL IERR( IER, IUA) 

SET THE SWAPPED FLAG. 

ISWCO=-l 
CONTINUE 

END OF FLOAT SECTION. WERE ANY SWAPPS MADE?? 
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FMP 



0239 




0240 


C 


0241 


c 


0242 


c 


0243 




0244 


c 


0245 


c 


0246 


c 


0247 


c 


0248 


c 


0249 




0250 


c 


0251 


c 


0252 


c 


0253 




0254 




0255 


c 


0256 


c 


0257 


c 


0258 




0259 




0260 


c 


0261 


c 


0262 


c 


0263 




0264 




0265 


c 


0266 


c 


0267 


c 


0268 




0269 




0270 




0271 


c 


0272 


c 


0273 


c 


0274 


c 


0275 




027 6 




027 7 


c 


0278 


c 


027 9 


c 


0280 




0281 




0282 


c 


028 3 


c 


0284 


c 


0285 




0286 




0287 




0288 




0289 


c 


0290 


c 


0291 


c 


0292 




0293 




0294 




0295 


c 


0296 


c 


0297 


c 


02 98 


c 



IFC ISWC0)295, 300 

YES SO CONTINUE THE SORT 

295 CONTINUE 

END OF SORT 

TRANSFER THE FILE IN SORTED ORDER 

300 DO 390 I=l,NOREC 

READ THE ADDRESS 

CALL READFC IUSRA, IER, IADRS,4,L, I ) 
CALL IERR( IER, IUA) 

SET FILE USERFX TO THE ADDRESS. 

CALL APOSNCIUSRX, IER, IADRSC2), IADRSC3), IADRSC4)) 
CALL IERR( IER, IUX) 

READ THE RECORD 

CALL READFC IUSRX, IER, IBUF, 128, L) 
CALL IERR( IER, IUX) 

WRITE THE RECORD ON USERFY 

CALL WRITFCIUSRY, IER, IBUF,L) 
CALL IERRC IER, IUY) 
390 CONTINUE 

ALL OF THE FILE IS TRANSFERED SO WRITE AN EOF AND 
CLOSE ALL THE FILES. 

CALL WRITFC IUSRY, IER, IBUF, -1 ) 
CALL IERRC IER, IUY) 

PURGE USERA USING THE TRUNCATE OPTION 

CALL CLOSE ( IUSRA, IER, 100 ) 
CALL IERRC IER, IUA) 

CLOSE IUSERX AND IUSERA 

CALL CLOSE CIUSRX, IER) 

CALL IERRC IER, IUX) 

CALL CLOSECIUSRY, IER) 

CALL IERRC IER, IUY) 

END OF PROGRAM TERMINATE. 

END 

FUNCTION IERRC ICOD, I.D) 
DIMENSION MESSC13) 

THIS FUNCTION CHECKS FOR ERRORS AND IF ICOD IS <0 
THEN PRINTS IT ON THE SYSTEM TTY. IT THEN PAUSES. 
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0299 


C 


0300 


C 


0301 


c 


0302 


c 


0303 


c 


0304 


c 


0305 


c 


0306 




0307 




0308 


c 


0309 


c 


0310 


c 


031 1 




0312 


c 


0313 


c 


0314 




0315 


c 


0316 


c 


0317 


c 


0318 




03 19 




0320 




0321 




0322 




0323 




0324 




0325 





IF THERE IS NO ERROR IT JUST KETUKNS. 

IN AMY CASE THE ERROR CODE ICOD IS RETURNED AS THE VALUE 

SET UP THE MESSAGE 

DATA MESS/2H , 2HER. 2HR0> 2HR >2H ,2H 0>2HN , 2HFI,2HLE> 
C 2H , 2HUS>2HER»2H / 

SET THE RETURN CODE 

IERR=ICOD 

WAS THERE AN ERROR'!'! 
IF(ICOD) 10,99 

YES SET UP THE MESSAGE. 

10 I=-ICOD/10 

J=-ICOD-1*10 

MESS(5)=I*4008+2H00+J 

MESSC 13)=ID 

CALL EXECC2, WrtESS. 13) 

PAUSE 
9 9 END 

ENDS 
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SECTION III 
OPERATOR REQUESTS 



The operator controls the HP RTE File Manager (FMP) by 
operator requests entered through the system input device. 
These operator requests will cause the FMP to perform the 
functions shown in Table 3-1. 

Table 3-1. FMGR Operator Commands 



Command 
Format 


Description 


Page 


CL 


List the cartridge directory . 


3-7 


CO 


Copy all files on one cartridge to 
another cartridge. 


3-8 


CR 


Create a file-does not store data. 


3-8 


DC 


Request FMP to logically disconnect 
the cartridge from the system. 


3-10 


DL 


List the file directory. 


3-11 


DU 


Dump a file— does not create a file. 


3-13 


IN 


Initialize a cartridge. 


3-15 


LI 


List file contents. 


3-16 


LL 


Change assignment of output list 
device. 


3-16 


LO 


Change assignment of log device. 


3-17 


MC 


Notify FMP a cartridge has been 
mounted. 


3-17 


MR 


Move a relocatable binary file to the 
load-and-go tracks. 


3-18 


MS 


Move a source file to the logical 
source tracks. 


3-18 


PK 


Pack one or all mounted cartridges. 


3-19 


PU 


Purge a file. 


3-20 


RN 


Rename a file. 


3-20 


RP 


Restore a saved program. 


3-20 


SP 


Save an RTE System program - 
creates a type 6 file. 


3-21 


SA 


Create a file and save the logical 
source or load-and-go tracks. 


3-22 


ST 


Store a file— creates a new file. 


3-22 


SV 


Change error print-out severity code. 


3-24 


TR 


Transfer input control to another 
file, or logical unit number. 


3-24 


?? 


Expand error message. 


3-25 


EX 


Terminate FMGR. 


3-25 



COMMAND STRUCTURE 

The operator gains the attention of the FMP by scheduling 
the software module FMGR with the ON FMGR operator 
request. When FMGR runs, a colon (:) prompter is returned 
on the initial keyboard input device. If the input device is 
not a keyboard, the first command is read from the device 
that is the input. Each command is parsed, or resolved, by 
a central routine that accepts certain conventions. Com- 
mand syntex is described in Table 3-2 and, with the con- 
ventions described next, must be followed exactly. 

CONVENTIONS 

• A leading plus (+) sign in a numeric parameter is ignored. 
The number is assumed to be positive unless preceded 
by a minus (-) sign. 

• A numeric parameter immediately followed by the 
letter 'B' indicates the parameter is octal. 

• Each command from a device other than a TTY must be 
preceded by a colon (:). Entries from a TTY will be 
prompted for by a system generated colon — the opera- 
tor must not enter a second colon. 

• Each parameter is tested on the assumption that it is 
numeric. If it fails to convert it is then assumed to be 
ASCII. If the parameter is ASCII, the first six characters 
are saved. If less than six characters are entered, the 
parameter is padded to six characters with trailing blanks. 
For example, if 6 followed by a blank is entered as a 
parameter, the Parse routine would assume it to be nu- 
meric. If 6 blank x (a non-numeric character) is entered, 
the Parse routine would assume it to be ASCII. 

• Two commas or colons in a row mean a parameter 
assumes its default value. 

• Leading blanks and blanks on either side of a comma or 
semicolon are ignored. 

• An EOF encountered on the command input file causes 
a TR with no parameters. 



• All parameters are initially filled with zeros and flagged 
as not supplied, so FMGR can distinguish null (space or 
nothing) from zeros. 
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Table 3-2. Conventions in Operator Command Syntax 



Item 


Meaning 


UPPER CASE ITALICS 




These words are literals and must be specified as shown. 


lower case italics 




These are symbolic representations indicating what type 
of information is to be supplied. When used in text, the 
italics distinguishes them from other textual words. 


REad 




A combination of the above shows that the RE is a literal 
and is specified as shown. The remainder of the characters 
are for information only and may or may not be entered. 


[, item] 




Items with brackets are optional. However, if item is not 
supplied, its position must be accounted for with a comma. 
This causes item to default. 




, item 1 
, item 2 
, item 3 






This indicates that exactly one specified item, may be 
specified. 






This notation means "and so on." 


item I 
item 2 
item 3 




This indicates that there is a choice of entries for the 
parameter, but one parameter must be specified. 


DL [, cl[, msc]] 




The placement of the brackets indicates that the cl and 
msc parameters are both optional. However, if cl is not 
supplied, its position must be accounted for with a 
comma. This causes cl to default. 

Example: :DL, , JB 


namr 

namr =flle name [-.security c 




This is considered to be one parameter with up to five 
subparameters separated by colons (:). 


vde [:label[:flle type [.file size [.record size] ]]]] 


namr = logical unit number 






NOTE 




File size is specified in blocks, and record size is 
required only for type 2 files. 
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namr is the symbolic representation of the general file 
reference parameter for most of the FMGR commands. 
namr is considered to be one parameter, a file name, with 
up to five subparameters separated by colons (:). 

namr = file name [ : security code [: label [:file type 
[:file size [: record size] ] ] ] ] 

— or — 

namr = logical unit number 

namr can be a logical unit number of a TTY, punch, photo 
reader, card reader, magnetic tape, or any such device 
except a disc. 

FILE NAME 

A legal file name is six ASCII characters in length. The first 
character must not be a blank or a number. All characters 
must come from the set b thru <- (see Appendix E) exclusive 
of special characters "+" (plus, "-" (minus), "," (comma), 
and":" (colon). Imbedded blanks are not allowed. Only 
the first and second parameter of a FMGR Command can be 
a namr or have subparameters, and only the first and second 
subparameters may be non-numeric. 

NOTE 

All of the following described subparameters are 
initially filled with zeros prior to each command; 
thus, omitted parameters are taken as zeros. (Two 
colons in a row mean a subparameter is omitted 
or is defaulted to zero.) 

SECURITY CODE 

The security code can be ASCII or numeric characters, or a 
combination of both. The largest allowable number is 
32767. When a code is not specified it defaults to zero. 
The security code parameter is defined as follows: 

security file is not protected and can be read or 
code = - changed by any user. 

security file is write protected but can still be read 
code>0 - without security code. If 2's complement 
of positive code is given, then the file will 
be opened for both read and write. 

security file is protected and can not be opened with- 
code < - out the correct security code. 



LABEL 

The label parameter has three meanings as shown below: 

label > - indicates a cartridge reference (CR) number 
(positive integer) that is a numeric identifier 
assigned to all cartridges in the system. A 
listing of the cartridge directory (CL Opera- 
tor Command) would reveal a number under 
the heading CR. This is the cartridge label 
and is directly associated with a logical unit 
number. 

label = - indicates the first available disc which satis- 
fies the request to be used. Note that the 
discs are searched in the order they appear 
in the disc directory. 

label < - indicates the logical unit number of the disc 
to be used (e.g., -14 indicates logical unit 
number 14). 

NOTE 

The following subparameters, FILE TYPE, FILE 
SIZE, and RECORD SIZE, are used only if the 
file being described is to be created by the 
command. 



FILE TYPE 

File types are defined as follows: 

- non-disc file 

1 - 128-word record length, random access 

2 - user selected record length, random access 

3 - (and greater) random record length, sequential 

access 

4 - source program 

5 - relocatable program 

6 - RTE load module 

7 - absolute program 
> 7 — user defined . 
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FILE SIZE 

File size is always specified in blocks, where two sectors 
(128 words) equal one block. If a negative -file size is speci- 
fied, all of the available file space is allocated to that file. 
When the file is finished being loaded, the unused area is 
returned to the File Manager (i.e., the file is truncated to 
the area used. This is useful when it is desired for a file to 
not have any extents. 

RECORD SIZE 

Record size is required in the command only if the file is 
type 2. When a file is created (except type files), the 
record size parameter is put in the directory and may 
subsequently be recovered by the user interface (see the 
LOCF call) or by the LI Command. 

Examples of how namr may be specified are shown below. 

10 File is on LU10 W , a non-disc file. 



20B 



$XYZ:SC 



File is on LU20 8 (LU16 10 ), a non- 
disc file. The B suffix indicates octal. 



File name is "$XYZ' 
security code "SC." 



with ASCII 



ABS: -10;-3:2:40:6 File to be created will be named 
"ABS", have security code -10, 
be on LU3, type 2, 40 blocks 
long, and have 6-word records. 



A23456 : : : 20 



File to be created will be named 
"A23456" and be type 20; security 
and cartridge reference are not 
supplied. 



LOCKING 



When a cartridge is locked, only the locking program may 
access files or make directory changes on that cartridge. To 
other callers, it appears as if the cartridge is not mounted. 
A lock can only be obtained if all files on that cartridge are 
closed. A failure to obtain a lock is indicated by error -8. 

A cartridge is locked whenever FMGR: 

• is packing it, 

• is initializing it, 

• is removing it, 

• is creating a type file on it, 
3-4 



• is purging a type file on it, 

• mounts it and finds it has not been initialized. 

If a users program attempts an access of a locked cartridge, 
error code -13 will be transmitted. For example, if FMGR 
is packing a cartridge in the background, and another pro- 
gram in the foreground requests that a file on that cartridge 
be opened; the -13 cartridge locked error will result. This 
is because the cartridge is locked by FMGR when 
performing the pack. 

FMGR TURN-ON SEQUENCE 

The File Manager operator interface routine, FMGR, can be 
turned on using the RTE System command ON, FMGR; or 
by internal scheduling with a user's program. However, be- 
fore a brand new virgin moving head cartridge can be used 
on any RTE System it must be properly formatted. For- 
matting consists of doing format data commands on the 
whole cartridge and flagging any defective tracks as bad 
tracks. Formatting may be done by the controller diagnos- 
tic routine (HP 13041) or by the moving head RTE Genera- 
tor (HP 29014). If the cartridge has been previously 
formatted, the following procedure is not necessary — go 
on to the ON, FMGR Command. 

VIRGIN CARTRIDGE INITIALIZATION 

During initial moving head system generation, the operator 
is given the option of formatting all sub-channels. The fol- 
lowing procedure may be used to format new packs, or 
packs that may not have been mounted during the initial 
generation. Refer to the RTE manual, Section VI, parts 1 
and 3 for more details on cartridge formatting. 

1 . Load the moving head RTGEN (HP 290 1 4) using the 
BBL. 

2. Load and configure a TTY SIO driver. 

3. Start RTGEN at octal address 100; clear the switch 
register and push RUN. 

4. Answer the cartridge channel question as in a normal 
generation. 

5. a. Define the areas on the respective subchannels 

(number of tracks and starting track number) 
which are to be initialized. 

b. Define a subchannel higher than any defined in 
"a" that is not mounted (i.e., either the unit is 
not present or it is unloaded). For example; if 
the system has one drive (i.e., subchannels and 
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1), then define some tracks on subchannel 2. Then 
enter the /E. 



ON, FMGR 



CAUTION 



Do not define any cartridge areas in "a" that 
have existing systems or data that is to be pre- 
served on them. Steps 6 through 9 are important 
to prevent RTGEN from automatically formatting 
a cartridge area containing data. 



6. Assign the dummy subchannel as the system sub- 
channel. 

7. Do not assign an "AUX DISC". 

8. Assign the dummy subchannel as the scratch data. 

9. Set scratch origin to 0. 

10. The number of 128 word sectors per track is 48 for 
the HP 7900/7901 and 24 for the HP 2870. 

1 1 . Answer the rest of the questions as per a normal 
generation. 

12. When RTGEN asks: 

INITIALIZE SUBCHNL: 

X? 

answer YES for those channels to be initialized. 

13. After the last subchannel is initialized, RTGEN will 
try to initialize the dummy subchannel (because it is 
the system subchannel) and will find it down. This 
causes message: 

READY DISC AND PRESS RUN 

At this time the cartridges are formatted and the procedure 
is complete. 



Purpose 

To schedule the background program FMGR that 
allows communication between the FMP and operator. 



Format 

*ON, FMGR [, input [, log [, list [, severity code] ] ] ] 

Where 

input is the logical unit number of the input 

device. Default is LU1 (system teleprinter). 

log is the logical unit number of a two-way 
device for logging an error detected on a 
command from the input device. If an 
entry is not given then log assumes the 
logical unit number given for input, only 
if input is a TTY; otherwise, log assumes 
logical unit number 1 . 

list is the logical unit number of the list 

device. Default is LU6 (standard list 
device). 

severity is the error message severity code. Default 
code is 0. The options are: 

- All commands are echoed on the log 

device. Any error causes an appro- 
priate error number to be printed. 

1 - Inhibit command echo on log device. 

2 - Inhibit error messages to log device, 

unless the error is severe enough to 
cause control to transfer to the log 
device for a command input. 
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FMGR SCHEDULE 









Purpose 


To internally schedule the File Manager operator interface routine FMGR. 




EXT 


EXEC 




SCHED 


JSB 


EXEC 


Transfer control to RTE 




DEF 


RTN 


Return point 




DEF 


ICODE 


Request code 




DEF 


FMGR 


Name of program to schedule 




DEF 


PI 






• 




Up to five optional parameters 




DEF 


P5 




RTN 


SZA 




If not scheduled Loop. 




JMP 


SCHED 




ICODE 


DEC 


9 or 10 


9 = schedule with wait, 10 = no wait 


FMGR 


ASC 


3, FMGR 


Name of program to schedule 


PI 
P5 


■ 






Up to five optional parameters; see Comments 



COMMENTS 

• The optional parameters are defined in the ON, FMGR 
Command on the previous page. If desired to turn on 
FMGR to read its commands from a file name, PI 
through P5 may be defined as: 



PI 


ASC 1,FN 




P2 


ASCI, AM 


File name 


P3 


ASC 1,E 




P4 


DECx 


Severity code 


P5 


DECy 


List logical unit number 



FNAME can be any ASCII file accessible with a cartridge 
ID of 0, and a security code which allows reading (i.e., + or 
0). The log unit in the above call is defaulted to LU1. 



• If FMGR is dormant, it is scheduled and a zero is 
returned to the calling program in the A-Register. 



• If FMGR is not dormant, it is not scheduled by this call, 
and its status (which is some non-zero value) is returned 
to the calling program in the A-Register. 
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WAITING AND NO WAITING 

• A schedule with waiting (ICODE = 9) causes RTE to put 
the calling program in waiting status. The called program 
runs at its own priority, which may be greater than, less 
than, or equal to that of the calling program. Only when 
the called program terminates does RTE resume execu- 
tion of the original program at the point immediately 
following the schedule call. 

• A background disc-resident program must not schedule 
another background disc-resident program with waiting. 
RTE aborts the calling program and prints the error 
message "SC03". A real-time disc-resident program, 
however, may schedule another real-time disc-resident 
program with waiting, because real-time disc-resident 
programs are swapped according to their priority when 
they conflict over use of their core area. 

• All other schedule combinations are legal: a disc-resident 
can call a core-resident, a core-resident can call a disc- 
resident, and a core-resident can call a core-resident. 

• A Schedule EXEC Call with no waiting (ICODE = 10) 
causes the specified program to be scheduled for 
execution according to its priority. 



PARAMETERS 

• If FMGR is scheduled with wait and an MS command is 
executed, the scheduling program may call RAMPR to 
get the LS track and logical unit. These will be returned 
in parameter two in the same format as the base page LS 
word; i.e., the sign bit set indicates logical unit 3, else 2 
and the track number is in bits 14 through 7. 



• Schedule with wait example: 

DIMENSION I(5),NAME(3) 
EQUIVALENCE (IA,REG) 
DATANAME/2HFM,2HGR,2H / 

5 REG = EXEC(9,NAME,2HM Y 2HFI.2HLE,!) 

C IF NOT SCHEDULED, LOOr#F/(IA)5,10,5 * 

C PUT LS TRACK IN 1(2) 

10 CALL RMPAR(I) 



Cartridge List 



Purpose 

To list the active cartridge labels and their status. 

Format 
:CL 



COMMENTS 

• The computer lists the status information on the list 
file. Note that the list file can be a device (e.g., line 
printer), or a file (refer to the LL command). The 
information is preceded by the following heading: 



LU 



LAST TRACK 



CR 



LOCK 



Where 



LU = logical unit number of the cartridge. 

LAST TRACK = last track on that LU assigned to 
FMP. 

CR = cartridge reference number. 

LOCK = the locking program's name (or 

blank). 
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COpy files 


Purpose 




To copy 


or transfer all files from one cartridge to 


another 


;artridge. 


Format 






:CO, labell, labeU 


Where 




labell 


is the cartridge label where the files are 




presently residing. 


label2 


is the new cartridge label to which the 




files are being transferred. 




NOTE 




Both labell and label2 can be either 




an LU(-) or CR(+). 



COMMENTS 

• All files being transferred must have unique names (i.e., 
no two files having the same name can reside together on 
the same cartridge). If files with the same name are lo- 
cated on both labell and 1abel2 the file on labell is not 
copied onto label2, but is reported with a FMGR -002 
(duplicate name) error. For example, if files A, B, C, and 
D on cartridge label2 are to be copied to cartridge labeU, 
and file C already exists on labeU, the following informa- 
tion would be printed on the log device: 

:CO,2,3 

A 

B 

C 

FMGR -002 

D 



Restrictions associated with the COPY routine are as 
follows: 

a. labell and label2 are both mounted. 

b. labell is not labeU. 

c. Type 3 or above files must contain an EOF. This 
implies that all records between the beginning of the 
file and the end-of-file must be valid. 

NOTE 

The COPY routine transfers files record per 
record. Records longer than 128 words are 
truncated. 

CReate file 



Purpose 

To create a file name on a cartridge. 

Format 



:CR, namr 



Where 



namr is the file name and parameters. 



COMMENTS 

• Only a file name is created, no data is transferred. 

• Parameters not included in namr default to 0. 

The file type must be specified and not be type 0, and 
the size must be greater than 0. 

• If the file type is 3 or greater, an EOF mark is written 
at the beginning of the file. 



3-8 



FMP 



Operator Requests 



CReate type file 



Purpose 

To create type file with special directory entries for device control. 

Format 



,REad 
:CR, namrju ,WRite 
,BOth 



', BSpace 
,FSpace 
,BOth 



' ,EOf 
,LEader 
rPAge 
,numeric 



.Binary 

,AScii 

.numeric 



Where 



namr is the file name and security code parameter. The file type parameter is which is default. 

lu is the logical unit number of the device (not a disc) to be controlled. 

The REad, WRite, and BOth parameters indicate the legal input/output. 

REad indicates an input request is legal (implies FSpace). 

WRite indicates an output request is legal (implies no FSpace). 

BOth indicates both input and output requests are legal. 
The BSpace, FSpace and BOth parameters indicate legal spacing. Default is no spacing. 

BSpace indicates backspacing is legal. 

FSpace indicates forward space is legal. 

BOth indicates both backspace and forward spacing is legal. 

The EOf, LEader, and PAge parameters specify the control subfunction for the end-of-file 
WRITE request. Default is LEader if the driver number is 02 8 . If the driver number is greater 
than 16 89) default is EOf; otherwise the default is PAge. 

EOf specifies an end-of-file mark (magnetic tape). 

LEader specifies paper tape leader. 

PAge specifies page eject for line printer, or two line feeds for a TTY. 

numeric user specified control subfunction. The number entered is interpreted as decimal (unless 
followed by a B) with only the last five bits used. 

The following parameters specify the subfunction portion of the input/output request. Default is AScii. 

Binary specifies binary data transfer. (BI is used here. BN is used in Dump and Store.) 

AScii specifies ASCII data transfer. 

numeric user specified control subfunction. The number entered is interpreted as decimal (unless 
followed by a B) with only the last five bits used. 



COMMENTS 

• A type file may exist only in the file directory for the 
system disc (LU2). When created, the type file will 
be entered prior to all files as the first entry in the 
directory. This means that in order to assume this 
position the system disc must be locked when creating 
the type file. 



• A type file has a special directory entry (Appendix A), 
and is used to control devices other than discs which use 
standard peripheral calling sequences. Type files may 
exist only in the system discs' file directory and may only 
be created and purged by the operator interface FMGR. 
Cooperating programs may use type files as a means of 
controlling access to a device (see exclusive open in Sec- 
tion I). Type files also afford a measure of device inde- 
pendence in that the standard file commands can be used 
to control the device. 
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Dismount Cartridge 



Purpose 

To make a cartridge unavailable to the FMP, and 
remove its entry from the disc directory. 



CAUTION 



The DC command must be issued before 
a cartridge is removed. 



Format 



: DC, label 



Where 



label is the parameter relating to namr. 
label > indicates CR. 
label < indicates a logical unit number. 
label = is not allowed. 



COMMENTS 

• The cartridge designated by label is first locked (refer to 
the heading LOCKING). The cartridge's directory entry 
is then removed from the cartridge directory, and the 
last FMP track reported on the log device. It is suggested 
that this last track number be written on the platter to 
facilitate the future restoration of the cartridge with the 
MC Command. 

• The File Manager will not allow cartridges assigned to 
LU2 or LU3 to be physically removed with the DC Com- 
mand. This is because LU2 and LU3 are both located in 
the RTE System track assignment table, and must stay 
mounted in order to properly configure the table when 
the system is initially started (booted). If the DC Com- 
mand is issued to LU2 or LU3, the cartridge is locked 



and removed from the disc directory list. The cartridge 
is then immediately remounted at the bottom of the 
list. With this feature, the DC Command can be used to 
change the order of the cartridge directory list. For 
example, the directory list shown below is the order of 
cartridges immediately after the MC Command was used 
to mount the disc at LU14. 



LOCK 



LU 


LAST TRACK 


CR 


02 


0201 


00002 


03 


0201 


00003 


14 


0201 


00055 



To place the peripheral disc (LU14) at the top of the 
directory list, issue the following commands (for this 
example only): 

:DC,2 

:DC,3 

The File Manager will change the directory list as follows: 
LU LAST TRACK CR LOCK 

14 0201 00055 

02 0201 00002 

03 0201 00003 

• Application . The restriction on physically removing the 
cartridge assigned to LU3 can be circumvented if the 
following requirement and procedure are adhered to. 

• Requirement . All cartridges to be mounted at LU3 
must be initialized to use the same first track. It is 
recommended that track be selected as the first track 
to avoid the possibility of the loader or system placing 
a program in the area. 
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• Procedure. Enter the following commands. 

:DC, -3 (Insures all files are closed) 

Remove the cartridge from the drive and insert the 
replacement. 

:DC, -3 (Places new cartridge label in the disc directory) 

The above procedure will work only if both cartridges 
have been initialized to use the same first track 
(recommended track 0). If the new cartridge has not 
been initialized FMGR will lock it. An attempt to 
initialize the new cartridge at this point will result in 
FMGR error 59 because the directory tracks are already 
assigned to D.RTR. This is solved as follows: 

* RT, D.RTR (RTE command to release D.RTR tracks) 

* ON, FMGR (FMGR will reassign D.RTR tracks on 

LU2, then terminate) 

* ON, FMGR 

: IN, master security code, -3 etc. (Initialize LU3) 

This completes the procedure. 

• Application. Operator commands that use namr can 
take advantage of the default characteristic of the namr 
subparameter label. For example, when creating a file 
with the CR Command, and label is allowed to default 
to 0, the file is placed on the disc at the top of the 
directory list. Refer to the heading NAMR for more 
information on label. 



Directory List 



Purpose 

To list the contents of file directory of one or all of the 
mounted cartridges. 



Format 



: DL [, label[, master security code] ] 



Where 



label is the cartridge identification, positive for 
CR or negative for logical unit number. 

master is the two-character FMP master security 
security code designated at initialization 
code time. 

NOTE 

If the master security code is 0, default in com- 
mand will not obtain long list — a code (any 
code) must be supplied. 



COMMENTS 

• The label parameter indicates which cartridge file direc- 
tory is to be examined. If label is not present, or it is a 
0, all mounted cartridge directories will be listed. There 
are two list formats. Figure 3-1 shows the format when 
the master security code is not provided. 

• Figure 3-2 shows the format when the master security 
code is provided. In addition to the information 
described in Figure 3-1, the file security code plus track 
and sector addresses are provided. 
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Cartridge reference number 

— Command 

- Cartridge information label 



L 



:DL,2 



Next available track 

. Next available sector 

- No. of Sectors/Track 



Last FMP track on this disc 

No. of Directory tracks 



CR=00002- 



ILAB=SYSDIS NXTR=0133 NXSEC=074 #SEC/TR=096 LAST Tk= 0202 #DR TR=02 

NAME TYPE #BLKS/LU OPEN TO 

MT 00000 08 

REWND 00000 08 FMGR 

E.OF 00004 0000 1 

TAPNUM 00002 00128 FMGR 



♦ t t 

Type I— 



File Type 



File Name 



Number of blocks 
used by file, or a 
logical unit number 
if file is type 0. 



File is open to this program. 
Extents are indicated by a 
plus (+) sign preceding the 
extent number. Exclusive 
opens are indicated by a 
minus (— ) sign following 
the program name. 

Figure 3-1 . Short List 



DL,2,55 

CR=00002 
ILAB=SYSDIS NXTR=0133 NXSEC=074 #SEC/TR=096 LAST TR= 0202 #DR TR=02 



NAME 



TYPE #BLKS/LU SCODE TRACK SEC OPEN TO 



MT 00000 08 

REWND 00000 08 

EOF 00004 00001 

TAPNUM 00002 00 128 



00000 






00000 




FMGR 


00000 


0100 000 




123^5 


0100 002 


FMGR 



I t 



File security Track and sector 
code address 



Figure 3-2. Long List 
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Purpose 

To transfer the contents of a file to another file. 

Format 

:DV, namrl, namr2 [, record format, EOF control [Jile # [, tifiles ]] ] 
— or— 

:DU, namrl,namr2 V, record format [,file # [, #files ] ] ] 
|_, EOF control 

Where 

namrl is the name of the file, or logical unit number from which data is to be transferred. 

namr2 is the name of an existing file, or logical unit number (other than a disc) to which namrl is to be 

transferred. 

record is the record format as applied to namrl. Refer to Comments for more information. 
format 

EOF saves or inhibits end-of-file marks on namr2. Refer to Comments for more information. 



control 



NOTE 



Only one comma is required when record format and EOF control 
parameters are omitted. No comma required if only one of the 
parameters omitted. 

file # indicates the relative file to be written in on namr2. This parameter must be greater than if 
supplied. Default is 1 . For example, if file # is 3, then 2 files will be skipped on namr2, and the 
data will be placed in the third file, \inamr2 is a disc file, the indicated number of zero length 
records are skipped. 

#files indicates the number of files or zero length records to be transferred from namrl . This parameter 

must be greater than if supplied. Default for #files is as follows (refer to Figure 3-3 in Comments): 

namrl is a Disc File. 

a. file # not supplied, and #files not supplied. 

#files defaults to 9999 files and all of namrl is transferred. 

b. file # is supplied, and #files not supplied. 
#/?/es defaults to 1 sub-file. 

namrl is a Non-Disc File . 

a. file # supplied or not supplied, and #files not supplied. 

# files defaults to 1 sub-file. 

In the event it is not known how many files or sub-files exist, #files can be an exceptionally large 
number and only what is required will be transferred. 
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COMMENTS 

h 



namr (file) 



sub 



file 



t_ 



EOF (zero length record) 
Figure 3-3. Sub-File Example 

• namrl and namr2 must be defined. If either one refers 
to an illegal logical unit number, FMGR will be aborted. 

• The third parameter {record format) selects the record 
format. If this parameter is missing, default is derived 
from the file type as specified in the file directory entry 
for namrl . If the file type for namrl is not specified, 
final default is ASCII. The record format choices are: 

AScii indicates that ASCII records are to be 
transferred. 

BReloc. indicates that binary relocatable records are 
to be transferred. A checksum is done. 

BNary indicates that binary records are to be trans- 
ferred without checksum. 

BAbs. indicates that binary absolute records are to 
be transferred. A checksum is done. 

MTape indicates that magnetic tape ASCII records 
are to be transferred. 

MS indicates that magnetic tape SIO (System 

Input /Output) records are created on namr2. 
Standard records are expected on namrl. 

MSBR indicates magnetic tape SIO binary reloca- 
table records (same as MS + BR). 

MSBA indicates magnetic tape SIO binary absolute 
records (same as MS + BA). 

• The EOF control parameters (IHibit.SAve) controls end- 
of-file (EOF) marks when transferring data. (Refer to 
Section I, FMP Technical Discussion for more informa- 
tion on EOF marks.) If this parameter is missing, an 
EOF is written at the end of the data (end of file on 
input). In addition, \inamr2 is a logical unit number 
and refers to a punch device, or \inamr2 refers to a 
type file which was created with the LEader option, 
then an EOF (leader) is written at the beginning of the 
file. In either case, any zero length records (disc file), 

or imbedded EOF's (non-disc file) on namrl are ignored. 
For example, DU,8,9,AS,1,3 would merge three files on 
LU8 into one file on LU9. 

IHibit inhibits writing an end-of-file mark after the 
data. Useful only when namr2 is not a disc file. 



SAve saves any EOF's in namrl on namr2. In 

disc files, EOF's are saved by writing a zero 
length record, and interpreted by reading a 
zero length record. This is effective when 
several tapes or magnetic tape files are to be 
stored in one disc file and then separated 
again when the file is dumped. On magnetic 
tape the separation is by end-of-file marks, 
and on paper tape by leader. On relocatable 
files saved from the load-and-go area the 
EOF's will be between programs. 

• The Dump and Store Commands differ as follows: 

a. Store creates a file (unless logical unit version of 
namr2 is used), while Dump does not. 

b. Store applies file #andMS against the input file; 
Dump against the output file. 



NOTE 

The DUMP routine transfers file record per 
record. Records longer than 1 28 words are 
truncated. 



Normally, when a TTY is used for output, it is treated 
as a list device. This means that its EOF default is a 
double space. If the TTY is to be used to punch tape, 
this default must be avoided using one of the following 
means. 



a. Use the IH option — an EOF is not written. How- 
ever, leader is not punched. 

b. Create a type file referring to the TTY, and 
specifying LEader as the EOF parameter. In 
dumping to the type file (TTY) leader will be 
punched before and after the data. For example: 

:CR,TTY,l,BO„LE 
:DU, namrl, TTY 

The DU Command can be used to concatenate files. 
For example, to add file B to the end of file A the 
command would take the form of: 

:DU,B,A„2 

File B may be any legal namr and the omitted parameters 
may be as required to correctly read file B. 
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INitialize 



Purpose 

To initialize cartridge parameters and clear a cartridge 

directory, or change the master security code. 

NOTE 

This command does not format a brand new 
virgin cartridge. Refer to Virgin Cartridge Ini- 
tialization under the FMGR TURN-ON heading. 

Format (initialize parameters, clear directory) 

:IN, [master security code], Iabell,label2, id [,1st trk 
[,fflir trks [,#sec/trk [, bad tracks] ] ] ] 

Format (change master security code) 

:IN, master security code- -new security code 

NOTE 



-- are two minus signs. 



Where 



master is the two-character FMP master security 
security code designated at initialization time. 
code When changing codes, new implies a 

new code and is separated from the 
old code by two minus (-) signs. 

labell is the cartridge reference label, positive 

for CR or negative for logical unit 
number. If the cartridge has not been 
initialized, a CR label will not have 
been established; therefore, labell must 
be a negative logical unit number. 

labeU is the new cartridge reference label and 

must be > 0. 

id is the cartridge information label 

(ILAB - refer to Figure 3-1/3-2), and 
must have the characteristics of a legal 
file name. Refer to text under the 
heading NAMR for a description of a 
legal file name, id is printed in the 
head of the directory listing. 

1st trk is the first track to be used on the 
cartridge (relative to the first track 
assigned to RTE; see Comments). 
Null defaults to track 0. 

Mir trks is the number of directory tracks. Null 
defaults to 1 directory track. This 
parameter must be less than 48. 

#sec/trk is the number of 64 word sectors per 

track. Null is allowed only for cartridges 
on same channel as LU2 or LU3 in 
which case this parameter is ignored. 

bad tracks is the bad track list. Up to six track num- 
bers may be entered separated by commas 



INITIALIZE PARAMETER COMMENTS 

• Before a new cartridge can be initialized with the IN 
Command, it must first be mounted with MC Com- 
mand. For a brand new virgin cartridge, refer to the 
ON, FMGR Command. 

• On re-initialization, FMGR first checks that all files are 
closed (refer to LOCKING). If not, FMGR error -8 re- 
sults. FMGR then checks the new track parameters en- 
tered. If the new parameters raise the first track, or lower 
the directory into an existing file, the message FMGR 
060 is printed. This is a caution message that allows you 
to abort the initialization if incorrect track parameters 
have inadvertently been entered. Entering NO causes the 
initialization to be aborted (the ?? Command also aborts 
the initialization). Entering YES causes all files on the 
disc to be purged. 

• Initialization and re-initialization of the system and aux- 
iliary discs (LU2 and LU3) also present possible track 
assignment conflicts. If additional tracks are requested 
(i.e., first track parameter lowers FMP area into RTE 
system area), FMGR checks on the availability of the re- 
quired tracks, and assigns them if they are available. If 
all the required tracks are not available, the highest re- 
quired but not available track number is reported with a 
FMGR 059 error, and the IN Command is aborted. The 
IN Command can then be re-entered with the first track 
parameter equal to the track reported plus one. If fewer 
tracks are assigned during re-initialization, the excess 
tracks are returned to the RTE System. Note that if the 
first track is lowered, the disc must be packed to use the 
new area (see the PK Command). 

• Bad track information is returned to the user during 
RTGEN or, if discovered by the FMP, as an error return 
to the caller. Bad track information is entered using the 
FMGR Initialization Command. This information is kept 
in the affected disc's first directory entry. If, at creation 
or during a packing move, the area for the file includes a 
bad track, the first track of that file will be increased 
until the file no longer contains any bad tracks. If the 
CREAT routine is to use the rest of the disc, the whole 
area will be above the highest bad track. If, during 
packing, a file is found to include a declared bad track, 
the file will be purged. (Note: This can only happen 
through an explicit declaration of a bad track by an oper- 
ator who knows the system security code.) In this man- 
ner, only the PACK and CREAT routines need be aware 
of bad tracks. Bad tracks discovered by the FMP result in 
an error return to the caller. 

CHANGE SECURITY CODE COMMENTS 

• The current master security code is changed when two 
new characters are supplied for the new security code 
parameter. Exceptions are as follows: 

a. Colon, comma, or a leading blank are not allowed. 

b. Non-printing characters are acceptable. 

c. The master security code may be changed to zero 
(no security) by specifying blanks. 

• If the current master security code is zero (no security) 
then any two characters may be used for the security 
parameter; however, two characters must be entered to 
maintain positional relationship. 

• Be sure to remember the new code. Once it is entered, it 
cannot be obtained with any FMGR Command. 
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List 



Purpose 

To print the contents of a file on the current list file. 

Format 



:Ll,namr 



, Source 
, Binary 
, Directory 



Where 



namr 



is the name of the file, or a logical unit 
number. 



Source indicates ASCII source format. 

Binary indicates binary format. 

Directory indicates that only the header con- 
taining file information (directory 
entry) is to be printed. 

NOTE 

Only the first letter is required for the 
above format parameter. 



COMMENTS 

• If namr refers to a file, the file is listed with the follow- 
ing heading: 

file name T = file type IS ON CR cartridge label 
USING nnnnn BLKS R = record length 

• If namr is a logical unit number, then stars (*) are 
printed in place of the file name as shown below. 

***** T = IS ON Llbcx 

• The default format specifications are related to file 
types. If the format is not specified, source is assumed 
for type 0, 3 and 4 files. Binary is assumed for all other 
type files. 

• If the list device is a TTY, the listing starts in column 
one; otherwise, each line is preceded by two blanks. 

• Source format consists of a line number followed by 
the ASCII text. 

• Binary format for each record consists of: 

a. A blank line. 

b. The record number: REC#nnnnn 

c. A blank line. 



d. As many lines as needed for the record with eight 
words per line. Each word is printed in octal fol- 
lowed by ASCII if a legal ASCII character is found 
(illegal characters are filled with blanks). The octal 
and ASCII representations are separated by a vertical 
column of asterisks. Refer to Figure 3-4 for an 
example printout. 

Zero length records will be printed out as just a record 
number (parts a, b, and c only). 

• List does not support absolute binary files from paper 
tape. 

• Binary format for a full line is 72 characters on a TTY. 
On any other device, 74 characters are sent. Lines are 
truncated after the last non-blank character. The star 
separator is considered blank for this test. 

• List does not support records of more than 128 words, 
and if source mode, truncates the total line to 72 
characters. 



REC* 03001 

00000P 000000 
0B0000 



fl 0fl0P!0# 
O0PI0M0* 



CDVR12 



Figure 3-4. Example List of a Binary Record 
LLu (list file change) 



Purpose 






To change 


the current assignment of the list file. 


Format 






:LL 


namr 




Where 






namr 


is the name of a file, 
number. 


or a logical unit 



COMMENTS 

• namr may refer to any existing file or logical unit. 

• The list file is where the commands LI, CL, and DL 
direct their output. 
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LOglu (log device change) 



Purpose 

To change the logical unit number of the system log 
device. 



Format 



:LO, lu 



Where 



lu 



is the logical unit number of the new TTY 
type log device (i.e., DVROO or 05). Note 
that lu can not be a file name. 



COMMENTS 

• None 



Mount Cartridge 



Purpose 

To notify the FMP that a cartridge has been mounted 
and is available for use. 

NOTE 

A brand new virgin cartridge must be formatted 
prior to using the RTE System. Refer to Virgin 
Cartridge Initialization under the FMGR TURN- 
ON Heading. 



Format 



:MC,/« [, last track] 



Where 



lu is the logical unit number of the 

cartridge being mounted. 

last track is the last track on the cartridge 
available to the FMP. 

NOTE 

For a new cartridge, the last track parameter 
establishes the last track. For a previously 
initialized cartridge, use the last track reported 
in the DC Command when the cartridge was 
removed. 



COMMENTS 

• The following conditions apply to the last track 
parameter: 

a. If lu is 3, then last track is ignored and the RTE 
System defined last track is used. 

b. If last track is absent, and the disc driver is DVR3 1 
(moving head), the last track parameter is defaulted 
to the RTE System defined last track. 

c. last track must be supplied if the disc driver is 
DVR30 (fixed head), and lu is not 3. 



• This command places the cartridge at the bottom of the 
disc directory. 



NOTE 

If you desire to have this cartridge moved 
to the top of the directory, refer to the 
DC Command. 



• The lu parameter may be negative (to conform to the 
label definition) or positive, but in either case it is a 
logical unit and must refer to a disc. 



• If a cartridge is already mounted at lu, or the cartridge 
being mounted has the same label as a currently mounted 
cartridge, FMGR error 012 results and the command is 
aborted. Refer to the DC Command. 



FMGR checks the cartridge's directory (at the last track) 
to determine if the cartridge has been previously initial- 
ized. If the cartridge has been previously initialized, the 
cartridge label must be unique. If not unique, FMGR 
012 results. If the cartridge has not been previously 
initialized, it is locked (i.e., made unavailable). An 
Initialize Command must be issued to initialize and 
unlock the cartridge. 
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Move Relocatable 



Purpose 






To transfer 


the file at namr to the load-and-go area. 


Format 






:MR 


namr 




Where 






namr 


is the name of the file, or 


logical unit 




number to be transferred. 





COMMENTS 

• A checksum is performed on the data transferred. 

• namr may contain one or more relocatable modules. 

• If an EOF is detected on namr and the last record trans- 
ferred was not an END record (see Appendix F), FMGR 
will print: 

FMGR 006 

and suspend. The operator should load the remainder of 
the relocatable module and enter: 
*GO, FMGR 
on the system TTY. 

Move Source 



Purpose 




To transfer a 


file to a logical source (LS) track before 


operating on 


it with EDIT or the Assembler or one of 


the compilers 




Format 




:MS, namr [, prog name [,///]] 


Where 




namr 


is the name of the file, or logical unit 




number to be transferred. 


prog name 


is the name of a program. If given, the 




LS tracks are assigned to that pro- 




gram, if not given, the LS tracks are 




assigned to the program EDIT. 


IH 


is a literal. If supplied, the LS word 




on the base page is not set, and the 




RTE System LS command is required. 



COMMENTS 

• When this command is typed, the first LS track is 
reported on the log device as follows: 

FMGR 015 

LS IS ON LU n TRACK nnn 



If FMGR was internally scheduled with waiting (refer 
to ON, FMGR), the scheduling program may obtain the 
LU and track number by calling RMPAR after it regains 
control. The LU and track numbers are returned in 
RMPAR parameter number two in the same format as 
the base page LS word. That is: 

Bit 15=0 is logical unit 2 

Bit 1 5 = 1 is logical unit 3 

Bits 14—7 is the track number 

Bits 6—0 is the sector address (always = 0). 



• The MS command will not support files with record 
lengths greater than 1 28 words. 



It is not advisable to use FMGR as prog name, because 
all tracks assigned to FMGR are released upon entry to 
the MS command, and on termination of FMGR. 



• The Assembler and compilers (ASMB, FTN, FTN4, 
and ALGOL) also release any tracks assigned to 
them upon termination. Consequently, if another 
program in the RTE System is requesting tracks, 
your source program could be lost. (It is still 
accessible in the file however.) 
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PacK 



Purpose 

To close up gaps in between files and utilize the tracks 
left from purged files. 



Format 



:?K[, label] 



Where 



label is the cartridge reference label, positive for 
CR or negative for logical unit number. 
Note that if label = 0, or is not entered 
(default = 0), then all cartridges are packed. 
Exceptions are described in Comments. 



COMMENTS 

• The PK Command purges all files which contain bad 
tracks. The bad tracks must have been previously de- 
clared in the Initialize Command. Refer to Section I, FMP 
Technical Discussion for more information on bad tracks. 

NOTE 

If you do not want the file with bad tracks 
purged, save it on another cartridge. 

• PK moves each file, if necessary, and updates the file's 
directory entry to reflect the new address. When the 
end of the file directory is sensed (i.e., all files have been 
packed), the PK Command then packs the directory 
removing any entries for purged files. 

• If during execution of the PK Command, the system 
should fail, it is possible to lose, at most, one file. The 
following data is provided to aid in determining which 
file, if any, may have been lost. 

a. A system failure during any part of a pack will leave 
the disc locked. This lock may be cleared by issuing 
a Dismount Cartridge Command (of course, you 
must then issue a Mount Cartridge Command unless 
the cartridge is LU2 or LU3). 

b. Files are moved into gaps (created by purges) one 
at a time as follows: 

1 . If the file is smaller than the gap, then the file 
exists in two places. The original place still con- 
tains good data, and is accessible through the 
directory — no file is lost in this case. 

2. If the file is larger than the gap, then when the 
gap is filled, a portion of the file being moved is 
overlayed. If a system failure occurred at this 



3. 



time, the directory could point to bad data. The 
affected file may be found by examination of 
the length, first track, and sector addresses the 
directory list provides. The file following any 
gap is the affected file. Its size may be compared 
with the gap to see if it was lost. Remember, 
the file's directory entry is updated last and any 
bad tracks affect the gaps left between files 
(see below). 

The directory entry is updated in place after 
the file is successfully moved. 



fl 



f2 



gap | bad ) f3 | f4 



track 



If O fits in the gap, f3 will be transferred; if 
not, the gap will be retained. 

c. After all files are moved, the directory is packed 
as follows: 

1 . The directory entries are first written on a disc 
track obtained by FMGR from the system. Only 
good entries are transferred; purged directory 
entries are omitted. A system failure at this 
time would lose nothing. 

2. This track is passed to D.RTR which in turn 
writes it into the directory area overlaying the 
old directory. A system failure at this time 
could result in the directory containing dupli- 
cate entries. This condition may be corrected by: 

a. Storing the affected files in new files with 
either different names or on different 
cartridges. 

b. Purging the affected files. 

c. Changing the names of the moved files back 
to the original names. 

A non-lock error (-8) or a disc not found error (-6) will 
be followed by an additional message indicating which 
disc could not be locked or found. When the label 
parameter is not specified, the cartridge will be reported 
as a -LU. If label is specified, the report will be the 
cartridge reference number (CR). Examples: 

:PK, 30 (30 not previously defined) 
FMGR -006 
FMGR 030 

:PK 

FMGR -008 (not lockable) 
FMGR -002 (LU2) 

In the last example LU2 will not be packed because 
there is at least one open file on it; however, all other 
mounted cartridges will be packed. 
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PUrge 



Restore Program 



Purpose 






To remove a file and all its extents from the system. 
Note that this command is the only method available 
to remove a type file. 


Format 






:PU, 


namr 




Where 






namr 


is the name of the file, 
number to be purged. 


or logical unit 



COMMENTS 

• If the file being purged is the last file on the disc (ex- 
cluding a type 6 file), all area from the last unpurged or 
type 6 file up to and including the purged file, is returned 
to the system. If a purged file is not the last file, then its 
area may be recovered only by packing, or by purging 
all files after it in the directory. Type 6 file area may 
only be recovered by packing. 

Re Name 



Purpose 




To change a file name to a new name. 


Format 




:RN, 


namr, nuname 


Where 




namr 


is the existing file name and parameters. 


nuname 


is the new name unique to the cartridge. 



COMMENTS 

• The file specified by namr must not be open when this 
command is issued. If namr has a non-zero security, the 
proper security code must be included. If namr includes 
a cartridge reference number, only that cartridge is 
searched for namr; otherwise, all mounted cartridges are 
searched. In the case where all cartridges are searched, 
only the first file found with the given namr will be 
changed. 



Purpose 




To restore 


a program (file) saved by the FMP, so that 


it may be run in the RTE System. 


Format (to restore a program) 


:RP, 


namr 


Format (to 


assign program 's ID segment to namr) 


:RP, 


namr, program 


Format (to release program 's ID segment) 


:RP, 


, program 


Where 




namr 


is the name of a type 6 file on LU2 or 




LU3 which was created on the current 




system using the SP Command. Note 




that a logical unit number is not 




allowed. 


program 


is a program name. 



COMMENTS 

• The program assigned as an RTE System program may 
be accessed by all the usual RTE System Commands. 
The program is given the same time parameters and 
priority assignment as when it was saved. 

• namr must refer to a type 6 file on LU2 or LU3 which 
was created on the current system using the Save Pro- 
gram Command. (Note that namr may not be a logical 
unit number.) The first five characters of namr define 
the program name which need not be the name the pro- 
gram had when it was saved with the SP Command. For 
example, a program with an actual name of SMPLE 
(NAM statement in program) is saved as SMPLE. The 
file name is later changed from SMPLE to TEST01 with 
the 

RN, SMPLE, TEST01 

command. When it is restored with the RP Command, 
TEST01 (the type 6 file name) would be used. Then 
when the program is scheduled in the RTE System, 



*ON,TEST0 



would be used. 



• nuname is the new name of the same file. Sub- 
parameters cannot be changed with this 
command. 



• If the program saved is still in the system, and the pro- 
gram is restored using the same name it was saved with, 
FMGR error 023 results (Duplicate Program Name). 
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• In the first Format example shown, the first five charac- 
ters of the file name will be the program name. A blank 
ID segment is established to point to the tracks belong- 
ing to the named file. If FMP cannot find a blank ID 
segment, an FMGR error 014 results. 

• In the second Format example shown, the program 
called namr would use program 's ID segment. Program 
must be inactive and must have been set up by a previous 
RP Command. Program is removed from the RTE Sys- 
tem. If program does not have an ID segment, an FMGR 
error 009 results and RP reverts to the first Format. If 
program is not inactive, FMGR error 018 results. This 
problem is solved by issuing the RTE System Command: 

OF, program, 1 

• If the program has completed and it is desired to return 
the ID segment to the RTE System, the third Format 
example is used. If program did not have an ID segment, 
FMGR 009 results but does not transfer to the log device. 

• The file namr may be purged while an ID segment points 
to it, and while it is running in the system. The program 
is not affected in any way (in the RTE System) by this 
action. To recover the file's space on the cartridge (with 
the Pack Command), the file's ID segment must first be 
released with the command: 

:RP, , program - or - *OF, program, 8 

Failure to return the ID segment before issuing the Pack 
Command results in the FMGR 01 1 error. 

• The RP Command does not permanently modify the 
RTE System area of the cartridge. Therefore, any pro- 
gram assigned will not be present on rebooting of the 
system. 





Save Program 


Purpose 






To place a 


disc resident 


program into a type 6 file. 


Format 






:SP, 


namr 




Where 






namr 


is the name 


of a disc resident program. 




Note that a 


logical unit number is not 




allowed. 





COMMENTS 

• namr is created as a type 6 file, and the current system 
program with the same name as namr (first five charac- 
ters), is stored in namr. 



• A program's name is a maximum of five characters long 
(i.e., SMPLE). A file name can be six characters long. 
Therefore, it is possible to create a type 6 file called 
SMPLE 1 for one version of the program, and another 
called SMPLE2 for a second version of the same 
program. If the program's name is less than five charac- 
ters long, the program must be saved using only the 
characters in the name. For example, if a program's 
name is LOCF, it must be saved using the 

:SP, LOCF 

command. To change the program name use the RN 
Command thus, 

:RN,LOCF,TEST01 

When restoring the program use 

:RP,TEST01 
When scheduling the program in the RTE System use 

*ON,TEST0 

• The SP Command is usually used in conjunction with 
the RP Command. For example, you have a source pro- 
gram that you have debugged, edited, compiled, and 
loaded, and have successfully run in the RTE System. 
You want to save this program in its present loaded 
form for a future use, without having to recompile, re- 
load, etc.. Issue the SP Command using the program's 
name, and a type 6 file with the same name is created. 
Later, to rerun the program, use the RP Command, and 
then issue the RTE System ON Command. The program 
can be saved while it is running. After it has been saved 
it can be aborted with the RTE System Command: 

*OF, program, 1 

— or — 
*OF, program ,8 

NOTE 

The SP Command will store the program file on 
any mounted cartridge (through the label sub- 
parameter of namr). However, the file must be 
located on LU2 or LU3 before the RP Command 
will accept the file. The file may be moved with 
the ST Command. 

• The following namr parameters are treated as shown: 

security code is defaulted to 0, otherwise user selected. 
label is defaulted to -2. 

file type is forced to type 6. 

file size is forced to the required size. 

record size is forced to 128. 
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SAve 



STore 



Purpose 




To save the logical source (LS) or load-and-go 


area (LG) 


in a file. 


Format 




:SA 


,LS 

namr 
, LO 


Where 




LS 


indicates the logical source area 


LG 


indicates the load-and-go area 


namr 


is the name of a file (created by this com- 




mand), or a logical unit number. 



COMMENTS 

• The SA, LG implies a checksum. After each end record, 
including the final end record, either a zero length record 
(disc file), or an EOF (non-disc file) is written, depending 
on the file. 

• The file size, if not specified, is defaulted as follows: 

a. The SA, LG Command computes the maximum pos- 
sible file size from the amount of LG area used, and 
uses this size to create the file. Therefore, extents 
will never be created, and the file will only be as 
long as needed. 

b. The SA, LS Command sets the size to one-half the 
number of blocks on a system disc track. 

• After the EOF is written, its position is checked. If ex- 
tents were created, the file size is not shortened. If the 
EOF is within the main file, the remaining unused disc 
space is returned to the system. 

• The file type, if not specified, is defaulted as follows: 

:SA, LS - defaults to type 4 (source) 
:SA, LG - defaults to type 5 (relocatable) 

• If there is not enough cartridge space available to accom- 
modate the file, an FMGR -6 error results, and any por- 
tion of the file already saved is purged. 

NOTE 

The Save Command does not support 
records longer than 128 words. 



Purpose 

To transfer or store records from a file or logical 
unit number, to another file or logical unit number. 
Note that namr2, if not a logical unit, is created by 
this command. 
Format 

:ST, namrl, namr2 [, record format, EOF control 
[, file #[,# -files]]] 

- or — 

record format [,file #[,#files] ] ] 
EOF control 



: ST, namrl 

Where 
namrl 



namr2 



[:: 



namr2 



record 
format 
EOF 
control 



is the name of the file, or logical unit num- 
ber from which data is to be transferred, 
is the name of the file, or logical unit num- 
ber to which namrl is to be transferred. 
namr2 is created by this command. 
is the record format as applied to namrl. 
Refer to comments for more information, 
saves or inhibits the end-of-file marks con- 
tained in namrl . 

NOTE 



Only one comma is required when record 
format and EOF control parameters are 
omitted. No comma required if only one 
of the parameters omitted. 

file # indicates the relative position the file is to 
be read from on namrl . This parameter 
must be greater than if supplied. Default 
is 1. For example, if file #is 3, then 2 
files (or zero length records) will be skipped 
on namr2, and the third file will be read. 

#files indicates the number of files or zero 
length records to be transferred from 
namrl . This parameter must be greater 
than if supplied. Default for #file is as 
follows (refer to Figure 3-3 in Comments): 
namrl is a Disc File. 

a. file #not supplied, and #file not 
supplied. 

#file defaults to 9999 files and all of namrl 
is transferred. 

b. File #is supplied, and Affile not supplied. 
Affile defaults to 1 sub-file. 

namrl is a Non-Disc File. 
a. File # supplied or not supplied, and 
#file not supplied. 

#file defaults to 1 sub-file. 

In the event it is not known how many 
files or sub-files exist, fifties can be an 
exceptionally large number and only what 
is required will be transferred. 
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COMMENTS 



sub 



namr (file) 



H 



file 



1 EOF(: 



zero length record) 



Figure 3-5. Sub-File Example 

• namrl must be defined. If either namr refers 

to an illegal logical unit number, FMGR will be aborted. 

• The file type parameter for namr2 is defaulted as follows. 

To namrl's type if namrl is a disc file. 

To 3 when using MT, MS, AS. 

To 5 when using MSBR, BR. 

To 7 when using MSBA, BA. 

To 3 when none of the above is specified. 

File size parameter for namr2 is defaulted to one-half a 
system disc track. 

• The namr2 parameter can be a logical unit number 
(non-disc file), but not a type file. 

• After the EOF is written, its position is checked. If ex- 
tents were created, the file size is not shortened. If the 
EOF is within the main file, the remaining unused disc 
space is returned to the system. 

• The third parameter selects the record format. If this 
parameter is missing, default is derived from the file 
type as specified in the file directory entry for namrl . 
If the file type for namrl is not specified, final default 
is ASCII. The record format choices are: 

AScii indicates that ASCII records are to be 
transferred. 

BReloc. indicates that binary relocatable records are 
to be transferred. A checksum is done. 

BNary indicates that binary records are to be trans- 
ferred without checksum. 

BAbs. indicates that binary absolute records are to 
be transferred. A checksum is done. 

M Tape indicates that magnetic tape ASCII records 
are to be transferred. 

MS indicates that magnetic tape SIO (System 
Input/Output) records are expected on 
namrl . Standard records are written on 
namr 2. 



MSBR indicates magnetic tape SIO binary relo- 
catable records (same as MS + BR). 

MSBA indicates magnetic tape SIO binary absolute 
records (same as MS + BA). 

• The IHibit, SAve portion of the third parameter controls 
end-of-file (EOF) marks when transferring data. (Refer 

to Section I, FMP Technical Discussion for more informa- 
tion on EOF marks.) If this parameter is missing, an 
EOF is written at the end of the data (end-of-file on in- 
put). In addition, \inamr2 is a logical unit number and 
refers to a punch device, or \inamr2 refers to a type 
file which was created with the LEader option, then an 
EOF (leader) is written at the beginning of the file. In 
either case, any zero length records (disc file), or imbed- 
ded EOF's (non-disc file) on namrl are ignored. For 
example, DU, 8, 9, AS, 1 , 3 would merge three files on 
LU8 into one file on LU9. 

IHibit inhibits writing an end-of-file mark after the 
data. Useful only when namr2 is not a disc 
file. 

SAve saves any EOF's in namrl on namr2. In disc 
files, EOF's are saved/interpreted by writing/ 
reading a zero length record. This is effective 
when several tapes or magnetic tape files are 
to be stored in one disc file and then separ- 
ated again when the file is dumped. On mag- 
netic tape the separation is by end-of-file 
marks, and on paper tape by leader. On re- 
locatable files saved from the load-and-go 
area the EOF's will be between programs. 

• The Dump and Store Commands differ as follows: 

a. Store creates a file (unless logical unit version of 
namr2 is used), Dump does not. 

b. Store applies file # and MS against the input file; 
Dump against the output file. 

NOTE 

The STORE routine transfers file record per 
record. Records longer than 128 words are 
truncated. 

• The input file can be declared the system TTY {namrl = 
LU1). For example, the ST Command is entered on the 
system TTY as follows: 

:ST, 1,FILE1 : : : 4:2 
After the last subparameter, carriage-return, line-feed is 
entered. When this is completed the TTY just sits there 
waiting for your input (the colon prompt is absent). 
Type in as many lines as desired (extents are automatical- 
ly made if required). When the file is completed enter 
Control D for the EOF mark. Control will then return to 
FMGR (as indicated by the colon prompt). 
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SeVerity code change 



Purpose 

To change the system log severity code to a new 
number. 



Format 



:SV, number 



Where 



number is the new severity code number. 

- All commands are echoed on the log de- 

vice. Any error causes an appropriate 
error number to be printed. 

1 — Inhibit command echo on log device. 

2 — Inhibit error messages to log device, 

unless the error is severe enough to 
cause control to transfer to the log 
device for a command input. 



COMMENTS 

• If an error is detected, and the echo is inhibited, the 
erroneous command will be printed prior to the error 
message. 

TRansfer control 



Purpose 

To transfer control of FMGR to a file name or logical 
unit number. 



Format 



K- integer \ 



:TR r,namr 



Where 
namr 



■ integer 



is the name of a file, or a logical unit 
number. 

is a negative integer that denotes a 
transfer back that many steps. 



COMMENTS 

• There are three variations to the Transfer Command. 

a. TR f namr. This command transfers control to namr 
(either a file or a logical unit number). Before the 
transfer is executed, the namr in control is saved in 
a stack. If namr is a disc file, the current record 
number is also saved. 

b. TR (no parameter). This command causes control to 
be returned to the previous input namr. If it was a 
disc file, the records already read are skipped. If 
there was no previous input namr, the FMGR is 
terminated. 



c. TR. -integer. This command causes the specified 
number of transfers (e.g., TR, -2) with no param- 
eters (jump back through stack) to be executed. 

• Up to 1 input namrs may be stacked and then returned to. 

• If an error is detected at any time, and it is severe enough 
to transfer to the LOG unit, a :TR,LOG (unless current 
input is from the LOG) is executed. As many commands 
as desired may be entered from the LOG device followed 
by a TR Command with no parameters to get back to 
the statement following the erroneous statement. 

TRANSFER COMMAND EXAMPLES 

The following examples show a dialog between the system 
and operator. For clarity, the operator responses are shaded. 

a. Suppose several subroutines have been saved in the 
file system and are often needed by programs being 
developed. Suppose these subroutines are named 
SUB1 thru SUB 10 and that SUB1 calls SUB2 thru 
SUB5 and that SUB6 calls SUB1 and SUB7 thru 
SUB 10. 

Given this, we create the following files: 

file # 1 SUBS1 

:MR,SUB1 
:MR, SUB2 
:MR, SUB3 
:MR, SUB4 
:MR, SUB5 
:TR 

file #2 SUBS6 

MR, SUB6 
TR.SUBS1 
MR, SUB7 
MR, SUB8 
MR, SUB9 
MR, SUB 10 
TR 

Then, after compiling a program, requiring SUB1, 
into the load-and-go area, we can run the FMGR as 
follows: 



*ON, FMGR 

:TR,SUBS1 

:MR,SUB1 

:MR, SUB2 

:MR, SUB3 

:MR, SUB4 

:MR, SUB5 

:TR 

:EX 

SEND FMGR 



Transfer to SUBS 1 



Echo of SUBS 1 Commands 



Transfer back to TTY 
Terminate FMGR 



We could now run the LOADR to load the program. 
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If we needed SUB6, the dialogue would have been: 



?? 



*ON, FMGR 
TR, SUBS6 
MR.SUB6 
TR, SUBS1 
MR, SUB 1 
MR, SUB2 
MR, SUB3 
MR, SUB4 
MR, SUB5 
TR 

MR.SUB7 
MR, SUB8 
MR, SUB9 
MR, SUB 10 
TR 
EX 
SEND FMGR 



Transfer to SUBS6 
Echo from SUBS6 
SUB6 transfers to SUBS 1 



> Echo from SUBS 1 



Continuation of SUBS6 

Return to TTY 
Terminate FMGR 



b. We could also save a segmented program and then to 
restore it, we generate the file: 



RSSEG 



c. 



RP, MAIN 
RP,SEG1 
RP, SEG2 
TR 



which might be invoked to restore the program. 

If we inadvertently transfer to, for example, SEG10 
(from Example a), from the log device: 



:TR,SEG10 



Transfer 



A%&#ZZX@$SEG 1 0WT@ Echo of ASCII of NAM 

record 



FMGR 010 


Error Message 


A? 


Error Message (colon 




missing) 




On log device 



A TR at this point would just go back to SEG10; 
what we need is to go back to the file prior to 
SEG10, so we enter: 



:TR, -2 (on log device) 



Transfer back to file 
prior to error file 



Purpose 

To expand the last error message. 

Format 



:?? [,number] 



Where 



L 



number is the error code number. 

If number = blank - Last error code issued is 

expanded. 

If number = xx - The xx error code is 
expanded. 

If number = 99 - All error code messages 

are printed on the list file. 



COMMENTS 

• The ?? Command may be issued after any error number 
and will expand that message. If issued in response to 
the Initialize Command error 60, the message is printed 
and the Initialize Command is aborted. 

EXit 



Purpose 

To terminate the File Manager (FMGR). 
Format 
:EX 



etc. 



OPERATOR COMMAND EXAMPLES 

The operator commands presented in this section can be 
applied by two different methods. In first method, the 
operator manually enters each command on the TTY to 
accomplish a given task. Many commands could be in- 
volved, requiring a great amount of manual labor to enter. 
The second method uses the Transfer Command. The oper- 
ator lists all commands required to do his task in program 
form, that is, serially as shown in the following examples. 
These commands can then be punched on paper tape or 
cards (or typed directly into a file). A file can be created 
and these commands stored in it; control is then transferred 
to this file and the task is executed. Also, if desired, the 
commands can be entered through the paper tape reader or 
card reader by a Transfer Command to the appropriate 
logical unit number. 

The following examples describe in first person tutorial 
form one of the many different procedures that can be used 
to accomplish a task. Once the user becomes familiar with 
the HP File Manager and its vast powers, he can see how to 
alter these procedures in many different ways. 
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EXAMPLE NO. 1 

This example shows a method of recording a set of pro- 
grams on magnetic tape (hereafter called "mag tape") as 
relocatable binary in SIO format for use in generating future 
RTE Systems. As new or updated programs become avail- 
able, the File Manager will be used to update and rewrite the 
mag tape. 

Assume you will start with each of the relocatable binary 
programs stored on the disc as a separate file under control 
of the File Manager. For illustrative purposes, the files are 
named: 

EXEC 

SCHED 

RTIOC 

DVROO 

DVR31 

ASMB 

LOADR 

UPROG1 

UPROG2 

For later use in building the mag tape, create and store a 
file containing nothing more than an end-of-file (EOF). At 
the console, enter: 



*ON, FMGR 



:CR,EOF:::4:l 



(Create a file called "EOF" 
containing only an EOF) 



Now, plan to dump the disc files onto mag tape. Enter each 
file in turn, with due consideration of order of loading for 
later system generation (refer to the RTE Manual). Assume 
the mag tape logical unit number is 8, and it is enabled. 



:DU, EOF, 8 



(Transfer the EOF file to 
the mag tape) 



:DU, EXEC, 8, MSBR, IH (Transfer first program to 
mag tape) 

The third parameter, MSBR, transfers binary relocatable 
records onto mag tape (LU8) in SIO format. The fourth 
parameter, IH, inhibits writing an end-of-file after EXEC. 
This is necessary for subsequent use of the mag tape for 
RTE System generation. 

:DU, SCHED, 8, MSBR, IH 



Enter the commands to transfer each program onto the mag 
tape, including the two user programs. Make one change to 
enter the last program. To provide an EOF at the tail end 
of the program sequence, omit the inhibit (IH) parameter. 

:DU,UPROG2, 8, MSBR 

The mag tape is now complete and can be used in an RTE 
System generation. An extension of the process shown here 
could create a mag tape, holding a library of many programs, 
from which could be drawn a sub-set of programs selected 
for a particular RTE System, and easily duplicated for use 
on other copies of that system. 

Now, assume that the time has come to update the mag 
tape. The third program of the sequence on the mag tape, 
which happens to be RTIOC, is to be replaced with an up- 
dated version. The process to be used is to separate the pro- 
gram set after the third program; saving the first piece in a 
temporary file, dropping out the obsolete program, picking 
up the remaining programs, and storing this piece into 
another temporary file. A separate file is assumed to con- 
tain the new version of RTIOC. The various files will be re- 
combined and transferred from the disc onto the mag tape 
as a complete, updated set. 

There is a problem to be solved first. Remember that the 
programs were written onto the mag tape without any EOF 
separators between them. An easy way to replace these 
separators is to let FMGR inserts EOF's (actually zero-length 
records). Remember that FMGR inserts these zero length 
records after each end record on transfers made from the 
load-and-go tracks. Assume the mag tape and system have 
been made ready, that is, load-and-go tracks were established 
with an RTE System LG Command. Turn on the FMGR 
(ON, FMGR) and enter the command to read the mag tape 
into the disc file TEMPI; and from here, to the LG tracks. 
Note that the MR Command cannot be used directly because 
it does not accept SIO records. 

:ST, 8, TEMPI, MSBR (Create the file TEMPI) 



:MR, TEMPI 



(Transfer file to load-and- 
go tracks) 



Now, move the load-and-go tracks to a new file, TEMP2. 
:SA, LG, TEMP2 (Create the file TEMP2) 

In the Save process, FMGR inserted an "EOF" between each 
program. The programs are now separable. TEMPI can be 
purged, if desired, as it is no longer needed. 

Transfer the first two programs of file TEMP2 into another 
temporary disc file, TEMP3. 

:ST, TEMP2, TEMP3, BR, 1 , 2 (Create the file TEMP3) 
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Starting with the first file, two files are stored in TEMP3. 

The third program (RTIOC) is skipped, and the fourth thru 
the last program is stored in TEMP4. 

:ST, TEMP2, TEMP4, BR, 4, 10 (Create the file TEMP4) 

The first three programs were skipped by setting the file 
number parameter to 4. TEMP4 now contains the remain- 
der of the set, starting with the program DVR00. Refer to 
Figure 3-6. Note that the SAve parameter was not specified; 
therefore, TEMP3 and TEMP4 no longer contain the zero 
length records. 

:ST, TEMP2, TEMP3, BR J , 2 

IN TEMP3 



EXEC 



SCHED 



(SKIPPED) 
RTIOC I DVR00 




IN TEMP4 

:ST, TEMP2, TEMP4, BR, 4, 1 - 

Figure 3-6. Example File Structure 

The final parameter (10) is the number of files to be trans- 
ferred and can be any number greater than the remaining set. 

Now, combine the first section of the old mag tape; the 
new version of RTIOC; and the remainder of the old mag 
tape into one updated version. Assume the mag tape unit 
is enabled. Put an EOF at the head end, as before. 

:DU, EOF, 8 

:DU, TEMP3, 8, MSBR, IH (Dump TEMP3 to tape) 

Add on the new RTIOC. Assume it is in a file named 
RTIOC. 

:DU, RTIOC, 8, MSBR, IH (Dump new RTIOC to tape) 

The inhibit (IH) is needed to prevent an EOF from being 
written after the files, since we intend to add more files. 
Now, add the remaining programs stored in TEMP4. Omit 
"IH" to have the final program end with an EOF. 



:DU, TEMP4, 8, MSBR 



(Dump TEMP4 to tape) 



The updated mag tape is ready. Purge all old files that are 
left over from the operations just performed. 



EXAMPLE NO. 2 

This second example relates the commands required to have 
the File Manager store, list, and edit a source program. Then 
compile, load, save, and later run the program without any 
intervening paper tapes. 

Assume for purposes of illustration that you have written a 
program named "JEVA" in FORTRAN IV, and have pre- 
pared it as a punched paper tape. It is your ultimate aim to 
have the program JEVA stored in a file on the system disc. 
You plan to store the program as a load module so that it 
can be brought into core from time to time to execute in the 
background disc resident area. First, you wish to file tem- 
porary copies of the source program through various stages 
of editing. Second, you wish to keep copy, in the form of 
a file, of the relocatable binary code that results from 
compilation. 

The first action is to load the paper tape into a source pro- 
gram file (type 3) on the system disc. (Note, for simplicity, 
it is assumed that file security is not used on this system. 
Also, the system disc is assumed to be first in the disc 
directory so that parameters will automatically default to 
the system disc.) 

Place the paper tape in the photoreader, and enter the fol- 
lowing commands at the system console. (It is assumed that 
all is in readiness for the system to operate.) 



*ON, FMGR 
:ST,5,JEVA1 



(Create a file called JEVA 1) 



The paper tape is read and transferred to a disc file JEVA 1 
created as a result of this command. Default values for 
parameters 3,4, and 5 fit this case and simplify the entry 
of the command. 

In preparation for editing the source program, use the 
FMGR List Command to obtain a listing complete with 
line numbers. 



:LI,JEVA1 



(List the file) 



The listing is printed on the list device (LU6) since default 
parameters were used. 

Move the file to the LS tracks where the RTE System Editor 
can access it. 



:MS,JEVA1 
FMGR replies: 
FMGR 015 



(Transfer JEVA 1 to LS tracks) 



LS IS ON LU2 TRACK yy (Indicates LS pointer) 
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JEVA1 has now been transferred to the RTE System LS 
tracks under control of the program EDIT. The LS word 
on the base page is set due to a default parameter in the 
MS Command. The RTE System LS Command is unneces- 
sary. The FMGR should now be terminated in order to 
bring up the system Editor. 

:EX 
The FMGR replies: 

SEND FMGR 
Enter commands to the RTE System. 

*ON,EDIT, 1,2, 2 
The Editor replies: 

/EDIT: ENTER EDIT FILE 
Enter the contents of the edit file on the system console. 

lR,xx 

/E 

The Editor accepts the edit file, works it against the pro- 
gram JEVA1 , and puts the edited version on its tracks. The 
Editor prints the message: 

/EDIT: TRACKS IN NEW FILE 

/EDIT: nn, xx 

/EDIT: END OF EDIT RUN. 

The LS pointer must now be set to the new source file: 

*LS, nn, xx 

With the assumption that the edited version is acceptable, 
move the logical source tracks to a new file, JEVA2. 



*ON, FMGR 
:SA, LS, JEVA2 



(Create the file JEVA2) 



At this point, the source program named "JEVA" has been 
edited and stored in the file JEVA2. For cleanup, the pre- 
edit version in the file JEVA1 should be purged. 



Next, compile the program. Since the LS pointer still points 
to a copy left on the LS tracks, it is convenient to use that 
copy. However, should the copy on the LS tracks have van- 
ished due to intervening use of the LS word on base page 
by another user (or by a system reboot), the file copy in 
JEVA2 can be recalled to the LS tracks. Terminate the 
FMGR, define load-and-go tracks, and call for the FOR- 
TRAN compiler. 



:EX 

The system replies: 

SEND, FMGR 

Enter: 
*LG,2 



(Allocate 2 load-and-go tracks) 
(Compile JEVA2) 



*ON, FTN4, 2, 99 

The system replies: 
SEND, FTN 



Parameter "2" in the ON, FTN4 Command directs the com- 
piler to compile the contents of the LS tracks. Parameter 
"99" causes the results of the compilation, the relocatable 
binary program, to be transferred to the load-and-go tracks 
previously defined. The binary program should now be 
saved in a new file. 



*ON, FMGR 
:SA, LG, JEVAR 



(Create the file JEVAR) 



:PU,JEVA1 



(Purge JEVA 1) 



Next, it is planned to load the program with the RTE Load- 
er. After the loading operation, the resulting object code 
could be executed as a background disc resident program 
(refer to Part 5, RTE Manual). However, in this case the 
object code will instead be stored as a load module with the 
Save Program Command, and later returned to core by the 
Restore Program Command. Refer to the SP and RP Com- 
mands in Section III of the RTE File Manager Manual. 

Since the LG pointer is still directed to the program copy 
on the load-and-go tracks, that copy will be loaded. If the 
copy were no longer available, then the file JEVAR could 
be recalled to the LG tracks. To load the program, termi- 
nate FMGR and call for the RTE Loader: 

:EX 

The system replies: 

SEND, FMGR 
Enter: 

*ON, LOADR, 99 
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The loader prints: 

JEVA READY-LOADING COMPLETE 

Note that the program name rather than the file name is re- 
ported by the loader in this case. Should the RP Command 
have been used to return a load module stored in a disc file 
to the load-and-go tracks, the first 5 characters of the file 
name would define the program name. To save the program 
turn on the FMGR and use the SP Command. 



*ON, FMGR 
:SP, JEVA 



(Create type 6 file called JEVA) 



The program JEVA (name defined by the first 5 characters 
in the file name) is now saved in the new file. Note that the 
file could be created on any of the discs under FMP control. 
However, when it is desired to return the load module to 
core, JEVA must be residing on LU2 or LU3. 



Later, to restart JEVA, the RP Command is used. 

*ON, FMGR 

:RP, JEVA (Restore JEVA as a system program) 

The system assigns a blank ID segment (without tracks as- 
signed if possible), set up to point to the file area. JEVA is 
set up as a system program and can be accessed by any of 
the usual system commands. 

If the program is dormant, its ID segment can be returned to 
the system with the RP Command: 

:RP, , JEVA (Release ID segment) 

If the program is to be unconditionally aborted use the RTE 
System Command: 

*OF,name, 8 
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SECTION IV 
ERROR CODES 



FMGR AND FMP ERROR CODES 



The error code structure is divided into positive and nega- 
tive error codes. A negative error code is usually the result 
of an improper interface routine call. A positive error code 
is usually the result of an improper FMGR command. Since 
many of the FMGR operator commands use an interface 
routine (e.g., the Save Command uses the Create Routine to 
create the namr2 file), negative errors can be generated 
when using the FMGR operator commands. Due to the in- 
ternal interaction of calls within the FMP, an improper com- 
mand may cause FMGR to abort (returns control to RTE 
System), and leave files that are empty or otherwise incom- 
plete on the system. An example of this sort of error is: 

:ST,4,XYZ 

Here 4 is assumed to be the punch. The command will 
create file XYZ, and then FMGR will be aborted when it 
tries to read from 4; XYZ will therefore be empty and cor- 
rupt (i.e., no end-of-file is contained in it). XYZ should be 
purged as soon as practical. You must issue the ON, FMGR 
command to regain control and then purge the corrupt files. 

Unless otherwise stated, an error will cause a transfer to the 
log device without aborting FMGR. This is an actual TR 
command generated by the FMP to notify you that an error 
has been made, and remedial action is required. From this 
point input control is recognized only from the log device. 
As many commands as desired may be entered from the log 
device followed by a TR command (no parameters) to re- 
turn to the statement following the erroneous statement. 



When packing with the PK Command, a non-lock error (-8) 
or a disc not found error (-6) will be followed by an ad- 
ditional message indicating which disc could not be locked 
or found. When the label parameter is not specified, the 
cartridge will be reported as a -LU. If label is specified, 
the report will be the cartridge reference number (CR). 

Examples: 

:PK, 30 (30 not previously defined) 
FMGR -006 
FMGR 030 



:PK 

FMGR -008 
FMGR -002 



(not lockable) 
(LU2) 



In the last example LU2 will not be packed because there is 
at least one open file on it; however, all other mounted 
cartridges will be packed. 

Negative error codes are shown in Table 4-1. All routines 
(except STATUS) are listed across the top of the table, 
while errors are listed down the left side. This forms a 
matrix that shows which interface routines can be involved 
in an error. For example, error -8 can occur in the PURGE, 
OPEN, or RENAME routines. 

All positive errors are listed in numerical order following 
Table 4-1 and are self explanatory. Note that all interface 
routine error codes are also returned in the computer's 
A-Register. 
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Table 4-1. Negative] 


irror Codes 
















Error 
Code 


Error Description 


Creat 


Purge 


Open 


Close 


Read 


Write 


Lo- 
cate 


*Aposi- 
tion 


Re- 
wind 


*Posi- 
tion 


Re- 
name 


♦Con- 
trol 


* 
>0 


None 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


-1 


Disc down 


X 


X 


X 


X 


X 


X 




X 


X 


X 


X 




-2 


Duplicate name 


X 




















X 




-3 


Backspace Not Legal (Type 0) 




















X 






-4 


File too long or REC Size Error 
(Type 2) 


X 






!T — ' " 


















-5 


Attempt to read or position to a 
record not written, or on update 
write an illegal record length. 










X 


X 




X 




X 






-6 


Cartridge not found or file not 
found or no room 


X 





X 


X 




X 














-7 


Invalid security code 




X 


X 






X 










X 




-8 


File currently open: eight PGM 
or exclusive or LOCK rejected 




X 


X 
















X 




-9 


Attempt to open type as type 1 
or to use APOSN on type 




• 


X 










X 










* 
-10 


Not enough parameters 


X 


X 


X 


X 


X 


X 


X 


X 




X 


X 




* 
-11 


DCB not open 




1 




X 


X 


X 


X 


X 


X 


X 




X 


-12 


SOF or EOF read or sensed 










X 


X 




X 




X 




X 


-13 


Cartridge locked 


X 


X 


X 
















X 




-14 


Directory full 


X 










X 














-15 


Illegal name 


X 




















X 




-16 


Illegal Type or Size = (Creat) 


X 


X 






















-17 


Attempt to Read or Write on 
type which does not support 
the operation. 












X 








X 






-101 


Illegal parameter in D.RTR call. 
Possible operator error. Recheck 
previous entries for illegal or 
misplaced parameters. 


























-102 


Illegal D.RTR call sequence 
(lock not requested first or file not 
opened exclusively first). Possible 
operator error (e.g., physical 
removal of cartridge without 
issuing DC Command). 




























X - implies a TRANSFER to LOG device. 
- implies no TRANSFER. 

* - implies error or function is never reported on the log device. 



4-2 



FMP 



Error Codes 



Table 4-2. FMGR Error Messages 



Error 

Number 


Associated 
Routine 


Meaning and Action 


Additional 
Information 


001 
002 
003 


General 

System Initialize 
System Initialize 


Disc error. 
Initialize LU2. 
Initialize LU3. 


Logical unit. 


004 
005 

006 


System Initialize 

System Initialize 
MS 

MR.STJJU 


Illegal response to 002 or 003. 
Required track not available. 

FMGR is suspending itself; ready device and GO. 


Relative TAT position. 


007 
008 
009 


MR,SA,DU,ST 
System Initialize 
RP 


Checksum error. 

D.RTR not found in ID segments. Load D.RTR. 

ID segment not found (no implied transfer). 


- 


010 


Parse Routine 


Input error, re-enter statement. 

Caused by: 

Missing initial colon (non-TTY input). 

Supplied initial colon (TTY input). 

Command undefined. 

ASCII subparameter in subparameters 3 thru 5. 

Subparameters in other than first two parameters. 

More than 5 subparameters. 

Command too long. 


Portion of line up to 
and including error is 
printed, followed by 
a "?." 


Oil 
012 


PK 
MC 


Some system ID segments point to the disc to be packed. 
Do RP„xxxxx or OF,xxxxx,8 on all named programs; 
then re-enter PK Command. 

Duplicate logical unit or label. 


List of program names. 


013 
014 

015 


TR 
MS,SP,RP 

MS 


Transfer stack overflow. 

Program not found in system ID segments. 
Also, RP, no blank ID segments. 

Logical Source track report follows 
(No implied transfer). 


» 

Track and LU of created 
LS file. 


016 
017 
018 


RP 
RP 
RP 


The named file is not on logical unit 2 or 3. 
Move file to LU2 or 3 and re-issue. 

The named ID segment was not set up by FMGR - 
cannot be used or cleared. 

The named ID segment shows the program is not 
dormant; issue OF,XXXXX,l and then re-issue RP. 


- 
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Table 4-2. FMGR Error Messages (Continued) 



Error 
Number 


Associated 
Routine 


Meaning and Action 


Additional 
Information 


019 

020 
021 


RP 

CR 

CO 


Checksum or setup code failed. 

File was not set up by an SProgram command on the 

current system. 

The given logical unit is illegal (creating a type file). 

One of the specified discs is not mounted or both 
specifications refer to the same disc. 


- 


022 

023 
024-049 


CO 
RP 


The copy has been terminated. 

(NOTE: this is true of most copy errors regardless of 

this message being printed.) 

The given program name is already defined in a 
system ID segment. 

Not defined. 


- 


050 
051 
052 


IN,MR,SA,SP 

IN,DL 

IN,MC 


Illegal number of parameters; usually too few. 

Illegal master security code. 

Wrong logical unit. In response to 002 or 003, or no 
disc on given LU. 


~ 


053 

054 
055 


IN 

INJ}C,PK,DL 

IN,MC,DC,CR, 
DU,ST 


Illegal disc label. Reference label must be positive non- 
zero integer. Information label must be a legal file name. 

Disc not mounted. Issue MCartridge command. 

Missing parameter; re-enter command; could be a re- 
quired parameter which is usually optional. 


- 


056 

057 
058 


IN,DU,ST,CR, 
LO,SA,LI 

IN 

SA 


Bad parameter. No file tracks (i.e., all directory or last 
track below first track). 
ASCII code undefined. 

Bad track error. Track not within file area or track is in 
directory area. 

Load and go area is undefined or empty. 


- 


059 
060 


IN 

IN 


Track not available for re-INitialization (aborts 
Initialization). 

INitialization will cause loss of all files on this disc. 
Do you really want to? Answer: YES or NO. 
Caused by: 

a. First track is larger. 

b. Directory will extend into a file. 


Highest non-available 
track. 
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SECTION V 
FMP SYSTEM INSTALLATION 



GENERAL INFORMATION 



NOTE 



File Manager installation consists of two parts. The first 
part involves incorporating the package into the RTE 
System. The second part involves initializing the system 
and auxiliary discs with FMGR. 

FMP INSTALLATION 

The FMP must be configured into the RTE System during 
the program input phase of RTGEN - no provisions exist 
for on-line loading. (Refer to Section VI, Program Input 
Phase, of the HP Real-Time Manual.) The various modules 
of the FMP are numbered according to the order of their 
loading; other distinctions are as follows. 

FMGR 

The operator interface FMGR has a priority of 90, is seg- 
mented into five parts, and requires at least 5k of back- 
ground area. 

D.RTR 

Subroutine D.RTR has a priority of one, requires a few 
words over Ik of area, and is supplied as a foreground disc 
resident program. However, if space permits, it is recom- 
mended that it be made core resident for greater speed. 
This change can be made during the parameter input phase 
of RTGEN. The only constraint is that D.RTR have a 
higher priority than any program using the FMP. 

FMGR INITIALIZATION 

Each time the RTE System is loaded from the disc the 
FMGR program is scheduled. The first time that FMGR is 
scheduled it detects that the FMP has not been initialized to 
the system and auxiliary discs. Once this initialization pro- 
cedure (described in the following steps) takes place, later 
RTE System loads will still schedule FMGR, but initializa- 
tion is no longer necessary. 

When FMGR is scheduled, it obtains all available tracks on 
the system and auxiliary discs, and assigns the tracks to it- 
self. FMGR then prints on the system teleprinter (TTY): 

FMGR 002 



This is a request for the user to initialize the system disc 
(LU2) using the IN Operator Command. 



The security code entered at this time will be 
the system master security code. The code can 
be blank (no security) or any two characters 
(except a colon, comma, or leading blank). The 
two characters need not be printing characters. 
Remember, the code may not be obtained with 
any FMGR Command once it is set, so be sure 
and remember it. 
After a successful initialization of the system disc, FMGR 
checks to see if there is an auxiliary disc. If so, FMGR 
prints on the system TTY: 

FMGR 003 

This is a request for the user to initialize the auxiliary disc 
(LU3) using the IN Operator Command. If no tracks are to 
be assigned for the auxiliary disc, its label should be 
specified as zero. For example: 

:IN,JB,-3,0 

When a successful initialization is completed, FMGR assigns 
the tracks as per the IN Command parameters. FMGR then 
terminates (no message is printed) and returns control to 
the RTE System. 

If the initialization was not successful, that is, if any tracks 
were not available, FMGR prints: 

FMGR 005 

FMGR xxx 
005 identifies the message and xxx is the track's relative po- 
sition in the track assignment table. This implies the track 
number is printed for the system disc, and the track number 
plus the number of tracks on the system disc is printed for 
the auxiliary disc. Recoveries from this error condition are: 

a. Make the track available and then enter the following 
system commands: 

*RT, D.RTR 

*ON,FMGR 
This will force the FMGR to re-try the track assign- 
ment table setup. 

b. Re-initialize the affected disc declaring the unavailable 
tracks as bad (message will still be printed but may be 
ignored). 

c. Re-initialize the affected disc changing the first track 
to be above the unavailable track. 

If the unavailable track is the last system track, procedure 
"a" must be used; i.e., this track must be available to the 
FMP. 
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APPENDIX A 
TABLES 



This Appendix contains the following tables. 
A-l . Cartridge Directory Format 
A-2. File Directory Format 



A-3. Data Control Block Format 



kA. Record Format for Disc Files 



Table A-l. Cartridge Directory Format 



The Cartridge Directory is located on the first two sectors of the last track on 
the system cartridge (LU2). It contains key pointers to all mounted cartridges 
within the FMP realm. 



Sectors 



0/1 



Word 



Contents 






LU first cartridge 


1 


Last track for FMP 


2 


Label word 


3 


Lock word 


4 


LU second cartridge 
etc. 




— end of cartridge specs 
(up to 3 1 cartridges) 


124 





125 


Set up (initialized) code 
word 


126 


Set up security code 


127 


Spare 



Word 125 is the sum of the words in locations 1650 through 1657, and 1742 
through 1764. 

This order of cartridges can be changed. Refer to the DC Command. 

Lock word is either 0, not locked, or ID segment address of locking program. 
Only FMGR locks the cartridge in supported software. Locked cartridges are 
available only to the locker to other callers; they are considered not mounted. 
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Table A-2. File Directory Format (Continued) 



The fjist entry in each File Directory is the specifica- 
tion entry for the cartridge itsel f. Each entry is 16 
words long. The directory will start on the last FMP 
track of each cartridge in sector for all but the sys- 
tem cartridge (LU2), on which it starts in the next 
logical directory block. 



Word 


Contents 


0-2 


Six-character information pack label ./ 


3 


Label word (positive integer) t 


4 


First available track l 


5 


Next available sector - 


6 


Number of sectors per track / 


7 


Last available track for files + 1 (i.e., •. 
lowest directory track) 


8 


Negative of number of tracks in directory 


9 


Next available track \ 


10 


First bad track (or zero) 



1 5 Sixth bad track (or zero) 

Each cartridge has a short label (one word) and a long 
label. The short label is used for addressing the car- 
tridge, the long label (six ASCII characters) is never 
used by the FMP and is only used for further ID 
when listing directories. 

The sign bit will be set on word 1 . 

The directory sector address is obtained from the 

block address by the following formula: 

6 
Sector address = (block *14) mod #S/T 

where #S/T is the number of sectors 

per track. Directory blocks are 128 

words long. 



After the specification entry comes the entries for 
each file . Each entry is 16 words long. Note that 
for type file entries, words 3 through 7 are different. 

Word Contents 






NAME 1,2 


1 


NAME 3,4 


2 


NAME 5,6 


3 


file type 


4 


Track 


5 


Extent/sector 



Word 




Contents 


6 


Number of sectors in file 


7 


Record length (type 2 files only) 


8 


Security code 


9 


t 


10 


t 


11 


t 


12 


Open Flags 


13 


I 


14 


I 


15 


I 


For type files, entries 3 through 7 are: 


3 


0(type) 


4 


Logical unit number 


5 


End-of-file number 


Specified 




01XX for MT 


at 




10XX for paper tape 


Creation 




1 1XX for line printer 




NOTE 




XX = logical unit number 


6 


Spacing legal code 




Bit 1 5 = 1 backspace legal 




Bit =1 forward space legal 


7 


READ/WRITE Code 




Bit 15 = 1 input legal 






Bit =1 output legal 



If word 1 = then the end of directory. 
If word 1 = -1 then the entry was purged. 

Up to seven PGM'S may have the same file open at 
any given time. The open flags are either zero (not 
open), or are the ID address of the program the file 
is opened to. An exclusive open is indicated by the 
sign being set on the only open flag. 

Each time a file is opened, the ID tables for each pro- 
gram that already has the file open are checked to see 
if the program is dormant. If dormant, i.e., if the 
point of suspension is zero, the open flag will be set 
to zero. This does not close the DCB nor post a 
possibly unwritten record therein. 
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Table A-3. Data Control Block Format (Continued) 



The Data Control Block (DCB) is a 144-word array 
provided by the user program with one DCB required 
for each file opened. The DCB is used to: 

1. Prevent unnecessary directory accesses 
(usually an access is not needed once a file is 
opened). 

2. Keep track of current position within file. 

3. Provide a packing/unpacking buffer. 



Word 


1 

2 
3 
4 
5 
6 
7 



Address of directory 
entry for the file 



Contents 

Track/LU 

Offset Sector 

File type (may be overridden at open) 

Track 

Sector 

Number of sectors in file 

Record length (type 2 files only) 

Security code and open mode 





Bit 


Meaning 




15=1 


Codes agree 




15 = 


Codes do not agree 




0=1 


Update open 




= 


Standard open 


8 


Number of sectors per track 


9 


Open — 


Close flag 




open 


= ID segment address 




close ¥= ID segment address 


10 


Track 




Current 


11 


Sector 




location 


12 


Location of next word 


in file 



Word 




Contents 


13 


In buffer and write flag: 




Bit 


Meaning 




15 = 


Not in core 




15=1 


In core 




0=1 


Written on 




0=0 


Not written on 




14=1 


If EOF read 




14 = 


If EOF not read 


14 


Record count 


15 


Extent number 


16 


Buffer 128 words 



143 
For type files, entries 3 through 7 are: 

3 0(type) 

4 Logical unit number 

5 End-of-file code 

Specified [ OlXXforMT 

at 10XX for paper tape 

Creation 1 1 XX for line printer 

NOTE 

XX = logical unit number 

6 Spacing legal code 

Bit 15 = 1 backspace legal 
Bit =1 forward space legal 

7 READ/WRITE Code 

Bit 15 = 1 input legal 
Bit =1 output legal 
The DCB is free for other use after a PURGE, CLOSE 
and NAMF call. Once a file is open, the DCB is used 
to reference the file, the name no longer being needed 
or used. 
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Table A-A. Record Format For Disc Files 



FIXED RECORD LENGTH FILES 

Type 1 and 2 files will be written as presented. They will be packed and may 
cross sector and track boundaries. 

RANDOM LENGTH FILES 

Type 3 and above records will be preceded and followed by a length word 
which contains the length of the record exclusive of the two length words. A 
zero length record will consist of two zero words. An end of file will be 
indicated by a -1 for the length. 

SAVE PROGRAM FILES 

Save program files are created by the SP command as type 6 files; however, 
they will always be accessed as type 1 . 

The first two sectors of the file will be used to record ID information on the 
program as follows: 



Word 



Contents 








-1 (EOF if not forced to type 1) 


1- 


5 


Not used 




6 


Priority 




7 


Primary entry point 


8- 


13 


Not used 




14 


Program type 


15- 


16 


Not used 


17- 


21 


Time parameters 




22 


Low main address 




23 


High main address 




24 


Low base-page address 




25 


High base-page address 


26- 


27 


Not used 




28 


Checksum of words through 27. 




29 


System setup code word (same as disc 
directory word 1 25) 


30- 


127 


Not used 



The rest of the file will be an exact copy of the original program tracks. 
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APPENDIX B 
SUMMARY OF FMP ERROR PRINTOUTS 

FMGR ERROR CODES 
ERROR MEANING 

-17 ILLEGAL READ/WRITE ON TYPE FILE 

-16 ILLEGAL TYPE OR SIZE=0 

-15 ILLEGAL NAME 

-14 DIRECTORY FULL 

-13 DISC LOCKED 

-12 EOF OR SOF ERROR 

-11 DCB NOT OPEN 

— 1 {71 NOT ENOUGH PARAMETERS 

-00 ATTEMPT TO USE APOSN OR FORCE TO 1 A TYPE FILE 

-08 FILE OPEN OR LOCK REJECTED 

-07 BAD FILE SECURITY CODE 

-06 CR OR FILE NOT FOUND OR NO ROOM 

-05 RECORD LENGTH ILLEGAL 

-04 MORE THAN 32786 RECORDS IN A TYPE 2 FILE 

-03 BACKSPACE ILLEGAL 

-02 DUPLICATE FILE NAME 

-01 DISC ERROR 

000 NO ERROR 

001 DISC ERROR-LU REPORTED 

002 INITILIZE LU 2! 

003 INITILIZE LU 3! 

004 ILLEGAL RESPONSE TO 002 OR 003 

005 REQUIRED TRACK NOT AVAILABLE - RELATIVE TAT POSITION REPORTED 

006 FMGR SUSPENDED 

007 CHECKSUM ERROR 
00« D.RTR NOT LOADED 
00Q ID-SEGMENT NOT FOUND 

010 INPUT ERROR 

011 DO 0F,XXXXX,8 ON NAMED PROGRAMS 

012 DUPLICATE DISC LABEL OR LU 

013 TR STACK OVERFLOW 

014 REQUIRED ID-SEGMENT NOT FOUND 

015 LS TRACK REPORT 

016 FILE MUST BE AND IS NOT ON LU 2 OR 3 

017 ID SEGMENT NOT SET UP BY RP 

018 PROGRAM NOT DORMANT 

010 FILE NOT SET UP BY SP ON CURRENT SYSTEM 

020 ILLEGAL TYPE LU 

021 ILLEGAL DISC SPECIFIED 

022 COPY TERMINATED 

023 DUPLICATE PROGRAM NAME. 

050 NOT ENOUGH PARAMETERS 

051 ILLEGAL MASTER SECURITY CODE 

052 ILLEGAL LU IN RESPONSE TO 002 OR 3 

053 ILLEGAL LABEL OR ILABEL 

054 DISC NOT MOUNTED 

055 MISSING PARAMETER 

056 BAD PARAMETER 

057 BAD TRACK NOT IN FILE AREA 

058 LG AREA EMPTY 

050 REPORTED TRACK UNAVAILABLE 

060 DO YOU REALLY WANT TO PURGE THIS DISC? (YES OR NO). 
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APPENDIX C 
SUMMARY OF FMP CALLS 



Consult Section II for the complete details on each FMP 
call. The general format of an FMP call in Assembly 
language is: 

EXT name Declaration of subroutine. 



JSB name Transfer control to name. 



CREAT 

NAME ASC 
ISIZE DEC 



Creates a file. 

File name. 

Number of blocks in the file. If 
negative, use all of disc (see 
Comments). 













DEC 


Record length (used for type 2 




DEF 


RTN 


Return address. 






file only). 




DEF 


IDCB 


144 word DCB buffer address. 


ITYPE 


DEC 


File type (see Comments). 




DEF 


IERR 


Error code buffer address. 


ISECU 


DEC 


Security code. 




DEF 


Pi 


Define addresses 


ICR 


DEC 


Cartridge Label. 




DEF 


pn 


of parameters. 


FCONT 


RTE I/O control request. 


RTN 


return 


point 




ICON1 




See Section II for control 
information. 


IDCB 


BSS 144 


144 word DCB buffer. 


ICON2 




Function code - see Section II. 


IERR 


BSS1 




Error code returned here. 


FSTAT 


Return cartridge status. 


Pi 







Actual parameter 


ISTAT 


BSS 125 


Buffer of 125 words. 


pn 







values. 


LOCF 




Return information on DCB. 


For each FMP call (except FSTAT and RWNDF), this 


IREC 


BSS 


Next record number. 


appendix includes only 1 


the parameters pi through pn. 
















IRB 


BSS 


Relative block of next read. 


APOSN 




Sets address of next record. 
















IOFF 


BSS 


Block offset of next record. 


IREC 


DEC 




Record number of next record. 


JSEC 


BSS 


Number of sectors in the file. 


IRB 


DEC 




Relative block address of next 
record. 


JLU 


BSS 


File logical unit. 


IOFF 


DEC 




Block offset of next record. 


JTY 


BSS 


File type. 


CLOSE 




Closes DCB. 


JREC 


BSS 


Record size. 


ITRUN 


DEC 




+n = number of blocks to be 


NAMF 




Renames specified file. 








deleted from the end of the 


NAME 


ASC 


File's present name. 








file when it is closed. 
















NNAME ASC 


File's new name. 








-n = retain main file, delete 














extents. 


ISECU 


DEC 


Security code. 








n - = standard close. 


ICR 


DEC 


Cartridge label. 
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OPEN 

NAME ASC 
IOPTN OCT 
ISECU DEC 
ICR DEC 
POSNT 

NUR DEC 
IR DEC 

PURGE 

NAME ASC 
ISECU DEC 
ICR DEC 



Opens the named file. 

File name. 

Open options (see Section II). 

Security code. 

Cartridge label. 

Positions next access to specific 
record. 

New record number. 

Absolute vs. relative control 
parameter for NUR. 

Purge named file. 

File name. 

Security code. 

Cartridge label. 



READF 

IBUF BSS 
IL DEC 

LEN BSS 

NUM DEC 

RWNDF 

No optional parameters. 
WRITF 



IBUF BSS 



IL 



DEC 



Reads a record from open file. 

Data buffer. 

Read request length. 

Actual read length returned here. 

Record number to be read. 

Rewind type file/reset disc 
file. 



Write a record to an open file. 



NUM DEC 



Data buffer. 



Write request length. 



Record number to be written. 
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APPENDIX D 
SUMMARY OF OPERATOR REQUESTS 



namr=file name [ .security code [ .label [ :file type 
[ .file size [ .record size] ]]]] 

ON, FMGR [ , input [ Jog [,list [ , severity code]] ] } 

CL 

CO, labell, labeU 

CR, namr 



CR, namr, lu 



DC, label 

DL [ , label [ , master security code] ] 

DU, namrl, namr2 [ ,record format, EOF control [ Jile # 
[Mies]]] 



,REad 


' ,BSpace 


~,EOf 


' , Binary 






, WRite 


,FSpace 


, LEader 


,AScii 






,BOth 


,BOth 


,PAge 
, numeric 


_, numeric _ 




- 



DU, namrl, namr 2 



— or — 

, record format [ ,file # [ , # files] 



[: 



EOF control 



IN, [master security code ] , labell, label2, id [,lst trk 
[ ,#dir trks [,#sec/trk [ , bad tracks] ] ] ] 

IN, master security code - - new security code 



LI, namr 



, Source 
, Binary 
, Directory 



LL, namr 

LO, lu 

MC, lu [, last track] 

MR, namr 

MS, namr [, prog name [,IH]] 

PK [, label] 

PU,nawr 



Schedule operator interface FMGR. 
List active cartridge labels. 
Copy files from labell to label2. 
Create file name. 

Create type file. 

Dismount cartridge. 

List contents of file directory. 



Transfer contents of one file to another file (does not create 
namr2). 



Initialize cartridge parameters . 

Change master security code. 

Print file contents. 

Change assignment of list file. 

Change assignment of log device. 

Mount cartridge. 

Transfer relocatable file to load-and-go area. 

Transfer source file to EDIT or prog name. 

Pack a cartridge to recover purged areas. 

Purge a file and its extents from system. 
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RN,namr,nuname 

RP,namr 

RP,namr, program 

RP, , pro gram 

SF,namr 

SA, LS, namr 

SA, LG, namr 

ST, namrl, namr2 [jecord format, EOF control [,file# 
l#files]]] 



or 






ST,mmrl,namr2 \ ^rd format [,file# [,# flies], 
.EOF control 



SV, number 
TR 



, namr j 
, -integer I 



?? [, number] 



Change the name of a file. 

Restore program saved with SP Command. 

Assign program's ID segment to namr. 

Release program's ID segment. 

Save a disc resident program. 

Save logical source area. 

Save load-and-go area. 

Store contents of one file to another file (creates namrl). 

Change system log severity code. 
Transfer control. 
Expand error message. 
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HP CHARACTER SET 



RTE SPECIAL CHARACTERS 



MNEMONIC 


VALUE 


USE 


SOM (CONTROL A) 


1 


BACKSPACE 


S1 (2600 BACKSPACE) 


31 


BACKSPACE 


(CONTROL Y) 






EOT (CONTROL D) 


4 


SIMULATE 
END TAPE 



»r 














i 


. 


1 


"T 


»t 








1 


i 








, 


■ 


bs 





1 





■ 





1 





i 




b« 


























bj 


























bj 

1 



















































NULL 


DCo 


t 





® 


p 




■ 















SOM 


DC, 


! 


1 


A 













1 





EOA 1 DC 2 


" 


2 


B 


R 


__u . 










1 




EOM ' DC 5 


*■ 


3 


C 


S 


N 
""A" ' 
--S-- 

s 
— 1 " ■ 
_.G -. 

N 
"E" 















EOT 


0C4 

ISTOPI 


t 


4 


D 


T 


--U-- 
N 

A " 
H-S . 

s 

1 

--G -- 

N 

E 
--D- - 







J-J° 


1 


WRU 


ERR 


% 


5 


E 


U 







1 




o 


RU 


SYNC 


a 


6 


F 


V 







1 


1 


I 


BELL 


LEM 


(»(>OS) 


7 


G 


w 

















FEoj S 


( 


8 


H 


X 














1 




) 


9 


I 


Y 


'' 











1 





LF ' S 2 


* 




J 


z 















Vt»e Sj 


+ 


; 


K 


c 








1 








FF i S 4 


lawn* 


< 


L 


\ 


ACK 








1 





1 


CR S 5 


- 


- 


M 


1 


© 








1 


1 





SO S 6 




> 


N 


t 


ESC 








< 


1 


' 


SI ; S 7 


/ 


? 





- 


DEL 



Standard 7-bit set code positional order and notation are shown below with br the high-order 
and b, the low-order, bit position. 



EXAMPLE: The code for "R" i 
LEGEND 



b 7 
1 



NULL 


Null/Idle 


DC,-DCj 


SOM 


Start of message 


DC* (Stop) 


EOA 


End of address 


ERR 


EOM 


End of message 


SYNC 


EOT 


End of transmission 


LEM 


WRU 


"Who are you?" 


So-Sr 


RU 


"Are you ...?•" 


% 


BELL 


Audible signal 




FE o 
HT 


Format effector 


< 


Horizontal tabulation 


> 


SK 


Skip (punched card) 


t 


LF 


Line feed 


•*- 


V TAB 


Vertical tabulation 


\ 


FF 


Form feed 


ACK 


CR 


Carriage return 


© 


SO 


Shift out 


ESC 


SI 


Shift in 


DEL 


DC 


Device control reserved for 
data link escape 













Device Control 

Device control (stop) 

Error 

Synchronous idle 

Logical end of media 

Separator (information) 

Word separator (space, normally 

non-printing) 
Less than 
Greater than 

Up arrow (Exponentiation) 
Left arrow (Implies/Replaced by) 
Reverse slant 
Acknowledge 
Unassigned control 
Escape 
Delete/Idle 
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APPENDIX F 
RELOCATABLE TAPE FORMAT 



NAM RECORD 



CONTENT 
0151312 




EXPLANATION 

RECORD LENGTH =17 WORDS 
IDENT = 001 

CHECKSUM: ARITHMETIC 
TOTAL OF ALL WORDS 
IN RECORD EXCLUDING 
WORDS 1 AND 3. 



WORD 1 



WORD 2 



WORD 3 



15 




8 


7 




015 




8 


7 







15 




8 


7 



































1 


'//// 




S 






Y 






M 






B 






L 




///// 


1 



WORD 4 



WORD 5 



WORD 6 



SYMBL: FIVE CHARACTER 
NAME OF PROGRAM 



1514 



15 



15 



LENGTH OF 

MAIN PROGRAM 

SEGMENT 

(OR ZERO) 


LENGTH OF 
BASE PAGE 
SEGMENT 
(OR ZERO) 


LENGTH OF 

COMMON 

SEGMENT 

(OR ZERO) 



-A/C 



WORD 7 



WORD 8 



WORD 9 



A/C: BINARY TAPE PROCESSOR 
= IF ASSEMBLER 
PRODUCED 

= 1 IF COMPILER 
PRODUCED 




, r>j i 



TIME PARAMETERS 

12 RESOLUTION CODE 

13 EXECUTION MULTIPLE 

14 HOURS 

15 MINUTES 

16 SECONDS 

17 TENS OF MI LLISECONDS 

_____ rv> . 



WORD 10 



WORD 11 



WORDS 12-17 
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ENT RECORD 



15 



87 



WORD 1 



CONTENT 

0151312 4 3 015 





w, 




r> 


W/////M 


E 

N 




RECORD 




'//// 


E 


////////// 


T 


CHECKSUM 


LENGTH 




///// 


N 
T 


W///M 


R 

1 








///// 




'/////, 





WORD 2 



WORD 3 



EXPLANATION 

RECORD LENGTH = 7-59 WORDS 

IDENT = 010 

ENTRIES: 1 to 14 ENTRIES PER 
PROGRAM; EACH ENTRY 
IS FOUR WORDS LONG. 



15 



8 7 



015 



87 



015 



WORD 4 



WORD 5 



WORD 6 



1 



s 


Y 


M 


B 


L 


i 



SYMBL: 5 CHARACTER ENTRY 
POINT SYMBOL 

R: RELOCATION INDICATOR 
= IF PROGRAM RELOCATABLE 
= 1 IF BASE PAGE 
RELOCATABLE 



*-, 



15 




15 




8 7 




015 




87 









RELOCATABLE 






























ADDRESS 






s 






Y 






M 






B 






FOR 






























SYMBL 





























WORD 7 



WORD 10 



WORD 8 




WORD 9 



WORDS 4 THROUGH 7 ARE 
> REPEATED FOR EACH 

ENTRY POINT SYMBOL. 



015 



RELOCATABLE 
ADDRESS 



S 



WORD 59 
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EXT RECORD 



15 



87 



WORD 1 



CONTENT 
0151312 54 15 



RECORD 
LENGTH 


■ 


D 
N 


JH 


1 

E 
N 

R 

1 


CHECKSUM 



WORD 2 



WORD 3 



EXPLANATION 

RECORD LENGTH = 6-60 WORDS 

IDENT = 100 

ENTRIES: 1 TO 19 PER 
RECORD; EACH ENTRY 
IS THREE WORDS LONG 



15 



87 



15 



87 



15 



8 7 



S 


Y 


M 


B 


L 


SYMBOL 
ID 
NO. 



WORD 4 



WORD 5 



WORD 6 



SYMBL: 5 CHARACTER 
EXTERNAL SYMBOL 

SYMBOL ID. NO.: NUMBER 
ASSIGNED TO SYMBL FOR 
USE IN LOCATING 
REFERENCE IN BODY 
OF PROGRAM. 



15 



015 



S Y 




WORDS 4 THROUGH 6 REPEATED 
. FOR EACH EXTERNAL 

? SYMBOL (MAXIMUM OF 
19 PER RECORD). 



WORD 7 



WORD 60 
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DBL RECORD 



15 



87 



CONTENT 
0151312 



765 



015 





/// 


7// 




W// 






RECORD 
LENGTH 


i 


1 


D 

N 




NO. OF 

INST. 
WORDS 


CHECKSUM 



WORD 1 



IT 

WORD 2 



Z/C 



WORD 3 



EXPLANATION 



RECORD LENGTH = 5-60 WORDS 

IDENT = 011 

Z/C: BASE/CURRENT PAGE LOADING 

= FOR BASE PAGE 

= 1 FOR CURRENT PAGE 

NO. OF INST. WORDS: 1 TO 45 
LOADABLE INSTRUCTION 
WORDS PER RECORD 



1514 



015 1312109 76 43 1 015 



r 

/ 

' RELOCATABLE 
' LOAD 
' ADDRESS 

> 


R 


R 


R 


R 


I ABSOLUTE 
R f VALUE 



WORD 4 



WORD 5 



INSTRUCTION WORD 
R = 000 



RELOCATABLE LOAD ADDRESS: 
STARTING ADDRESS FOR 
LOADING THE INSTRUCTIONS 
WHICH FOLLOW. 

R's: RELOCATION INDICATORS: 

000 = ABSOLUTE 

001 = 15-BIT PROGRAM 

RELOCATABLE 

010 = 15-BIT BASE PAGE 

RELOCATABLE 

011 = 15-BIT COMMON 

RELOCATABLE 

100 = EXTERNAL REFERENCE 

101 = MEMORY REFERENCE 



1514 



1514 



/ 



15-BIT PROGRAM 
RELOCATABLE 
VALUE 



INSTRUCTION WORD 
R = 001 






1514 



15-BIT BASE PAGE 
RELOCATABLE 
VALUE 



INSTRUCTION WORD 
R =010 






15-BIT COMMON 
RELOCATABLE 
VALUE 



INSTRUCTION WORD 
R =011 



Rl IS RELOCATION INDICATOR FOR 
INSTRUCTION WORD); R 2 , FOR 
INSTRUCTION WORD2; ETC -MEMORY 
REFERENCE INSTRUCTIONS USE 
TWO WORDS, WITHIN THE TWO- 
WORD GROUP, "MR" INDICATES 
RELOCATABILITY OF OPERAND 
SPECIFIED IN SECOND WORD: 

00 = PROGRAM RELOCATABLE 

01 = BASE PAGE RELOCATABLE 
10 = COMMON RELOCATABLE 



1514 1110 



1 

N 




J! 

T 


EXTERNAL 
SYMBOL 
I.D.NO. 



t: 



D/l 



D/l- 



INSTRUCTION WORD 
R = 100 



151411109 


2 


101514 





1 


'//// 






/ 




N 
S C 


//// 


//// 




/ 




T O 
R D 
U E 


'/// 


'//// 


M 

R ' 


t 

1 
1 
1. 


RELOCATABLE 
VALUE 


C 
T 




v/A 


' 





u. 



z/c 



INSTRUCTION WORDS 
R = 101 



D/l: INDIRECT ADDRESSING 

= DIRECT 

1 = INDIRECT 

Z/C: BASE/CURRENT PAGE LOCA- 
TION OF OPERAND ADDRESS 
AS DETERMINED BY LOADER. 

= BASE PAGE 

1 - CURRENT PAGE 
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END RECORD 



WORD 1 



1514 



1 RELOCATABLE 
' TRANSFER 

I ADDRESS 

I 

i 



CONTENT 
0151312 




WORD 2 



WORD 3 



WORD 4 



EXPLANATION 



RECORD LENGTH = 4 WORDS 
IDENT = 101 



R: RELOCATION INDICATOR 
FOR TRANSFER ADDRESS 

= IF PROGRAM RELOCATABLE 
= 1 IF BASE PAGE 
RELOCATABLE 



T: TRANSFER ADDRESS 
INDICATOR 

= IF NO TRANSFER 
ADDRESS IN RECORD 

= 1 IF TRANSFER ADDRESS 
PRESENT 
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ABSOLUTE TAPE FORMAT 



15 



87 



RECORD 
LENGTH 



CONTENT 
015)4 



015 




ABSOLUTE 

LOAD 
ADDRESS 



WORD 1 



WORD 2 



INSTRUCTION 
WORD, 



WORD 3 



EXPLANATION 



RECORD LENGTH = NUMBER OF 
WORDS IN RECORD EXCLUDING 
WORDS 1 AND 2 AND THE 
LAST WORD. 

ABSOLUTE LOAD ADDRESS: 
STARTING ADDRESS FOR 
LOADING THE INSTRUCTIONS 
WHICH FOLLOW 



15 



15 




15 



INSTRUCTION 
WORD. 



CHECKSUM 



WORD n - 1 



WORD n 



INSTRUCTION WORDS: 

ABSOLUTE INSTRUCTIONS 
OR DATA 



CHECKSUM: ARITHMETIC 
TOTAL OF ALL WORDS 
EXCEPT FIRST AND LAST 



TEach word represents two frames arranged as follows: 

Bit 8 — 



Bit 15 — 









— Bit 

— Feed Holes 

— Bit 7 
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APPENDIX H 
THE BASIC PRINCIPLES OF INDEXING 



BASIC PRINCIPLES 



There are six basic principles which apply whether one is 
dealing with a collection of complex programs, or thousands 
of technical articles reduced to abstract form. 

1 . Balance input and output effort. 

2. Evaluate single entry and multiple entry files. 

3. Describe items fully. 

4. Control the vocabulary. 

5. Know the subject. 

6. Select appropriate index scheme. 

Consider each point and see how they tie together to pro- 
duce an effective index and retrieval system, but first, here 
are some necessary definitions. 

DEFINITIONS 

Data are numeric or quantitative notations. Data concepts 
are mutually exclusive. Data are easily manipulated by 
machines. The boiling point of lead is 1620°C. That is data. 

Information is knowledge concerned principally with quali- 
tative concepts or ideas. Information concepts are not 
mutually exclusive; the concepts interact and overlap. In- 
formation is not easily manipulated by machines as data. 
Information includes data. A qualitative discussion of 
ablation of plastics in heat shields of space vehicles would 
be information. Data are relatively easy to handle; informa- 
tion is more difficult. 

Records are reports, abstracts, books, articles and catalogs. 

Terms are used to represent concepts. In various systems 
they may be called descriptors, key words, uniterms, or 
subject headings. Terms identify the elements of informa- 
tion present in an item. Terms are stored as references to 
information. 

There are three distinct levels of retrieval. 

Reference Retrieval results when a search provides a list of 
item numbers or titles as the result. The inquirer gets the 
items and finds the answers. 



Record Retrieval results when a search provides the docu- 
ments or articles themselves as the results. The inquirer 
looks through the records for the answers. 

Information Retrieval results when a search provides infor- 
mation as the direct answer to the question. The inquirer 
reviews the material to see if it satisfies his request. The 
same would be true for data retrieval. 

Although there is much talk about information retrieval, 
in most cases it is reference or item retrieval. 

BALANCE THE INPUT AND OUTPUT EFFORT 

The usual approach is to spend a minimum of effort on 
organizing an index. When items are needed, the work be- 
gins. Long, frustrating, sequential searches are made through 
the index looking for specific items to fill an immediate 
need. Study the economics of the situation. Look at both 
input and output. Pause for a minute and analyze how 
large your index is and how much it is expected to grow 
each year. Assume you have 1 000 items which can be filed 
in chronological order. Each time material is needed it 
might be necessary to search these 1000 documents by 
going through the index serially from the first to the last. 
If many searches are made, a comprehensive index to the 
collection may be justified. However, if a search is made 
only once a year, or less, the cost of installing a detailed 
system could probably not be justified. Therefore, consider 
how many items are in the file, how many more will be 
coming into the collection, and how often these will be 
searched. 

EVALUATE SINGLE ENTRY AND MULTIPLE ENTRY 
FILES 

Before you store, consider how you will search. An insur- 
ance company keeps its records by account. All records on 
Charles Walker are kept in one file. The request usually is, 
"Bring me the File on Charles Walker." Since only a single 
entry to the file is required, it can be kept in an ordered 
arrangement by a unique name. The same is true in a store 
that keeps its credit accounts by customers. Here files are 
kept in a single entry arrangement since this is the way the 
file will be used. 

A single entry system can be used in chemistry for a file on 
physical properties of chemical compounds, if the only 
questions asked of the file are to supply the physical pro- 
perties of specific compounds. In this case, the most logical 
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filing order is by compound name. In science and techno- 
logy, however, this last situation does not usually occur. 
After a period of time of filing physical properties under 
the names of chemical compounds, along comes the prob- 
lem in which someone needs to know the names of all chem- 
ical compounds with a certain physical property value. Now 
the file must be approached from a new viewpoint; there is 
a need to know both the physical properties of a given 
compound, and all compounds with a given physical 
property. The need for multiple entry to collections is 
common in science and technology and most other areas. 
A body of knowledge is usually approached from more 
than one direction. When an engineer requires the test 
results from a single instrument for a certain event, retrieval 
may be difficult if the results were filed only under the 
event name. 

Early in your work decide whether your index can be man- 
aged with a single entry approach or whether it requires 
multiple entry search flexibility. 

DESCRIBE ITEMS FULLY 

If you are going to have a single entry system, pick the prop- 
er entry characteristic and set up your index. More likely 
you will need multiple entry and more effort is required. 

Traditional systems describe an item by perhaps one to four 
terms. This provides a limited number of ways of finding an 
item. More often it is desirable and necessary to index an 
item by perhaps ten, fifteen, or more terms in order to 
provide the proper degree of flexibility in finding what you 
want quickly and economically. 

Full description of the item is needed because most col- 
lections require multiple entry. If you are going to be able 
to answer a variety of questions, then you need to provide 
for this search flexibility. This is done at input by describ- 
ing each item fully, by indexing the item in anticipation of 
all the probable questions. The key questions to ask your- 
self are these: "In what ways am I apt to want this item in 
the future? What questions am I apt to ask for which I 
would like this returned?" Thinking about future use will 
help you describe the item properly so that you can find it 
easily later. 



CONTROL THE VOCABULARY 

The language for an information system is one of the most 
important features, yet it is often overlooked. Terms must 
be selected which bridge the communications gap from the 
language used by the originator of the item, to the person 
who stores it away, and then later, to the terms used in 
searching the index. The terms must be organized to take 
care of cross references and to provide consistency of input 
and search. However, the language must be flexible enough 
so that modifications and extensions can be handled easily. 
A modest amount of vocabulary control can assure that in- 
formation is not lost because ideas are referenced in one 
way and searched for in another. Before setting up a system 
think about the concepts which cover the area of interest 
and reflect on the kinds of questions that are apt to be asked 
of the collection. Some thought at this point and some set- 
ting down of these terms will be a major assist in organizing 
the vocabulary for efficient operation. 

KNOW THE SUBJECT 

The best qualified person to describe a collection is one who 
is intimately familiar with the area covered. The organiza- 
tion of a system is done best by the person who will be us- 
ing it. Finally, the best system will be the one installed and 
operated by someone knowledgeable in the subject area 
covered. Most efficient information systems in chemistry, 
for example, are operated by chemists. Often a system is 
turned over for indexing to a secretary or a clerk who may 
not have sufficient subject competence to describe an item 
well enough so that questions can be handled effectively. 

SELECT APPROPRIATE INDEX SCHEME 

Some type of index scheme is needed to provide the 
multiple entry. The FMP has two directories of its own; 
the main directory (disc directory) which contains infor- 
mation about all the area available to the FMP and the local 
directory (file directory) which contains information on 
each file located on the disc or "file drawer." A supple- 
mentary index should be formed as a master list for all files 
and records, their security codes, and for cross referencing 
purposes. 

Remember, 

"Those who cannot remember the past are condemned 
to repeat it." - Santayana. 
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Index 



INDEX 



Page 



Page 



APOSN 


2-3, 2-5 


End-Of-Data 






14 






End-Of-File 


14, 1-5, \-t 


>, 2-8, 2-13, 2-17, 


B 






2-22, 


,3-8, 


3-14,3-22,3-23, 










3-26, 4-1, A-2, A-3 


Bad Tracks 


3-4, 3-15, 3-19, A-2 


EOF 


14, 2-7, : 


2-14, 


2-15,2-18,2-19, 


Binary Format 


3-16 




2-22, 3-1 ; 


,3-8, 


3-14,3-16,3-22, 


Bit 7 


1-4 




3-23 


,3-26, 3-27, A-3, A- 4 


Blank Card 


1-4 


Error -13 






34 


Blocks 


1-5,2-1,2-6,2-7,2-10,2-22 


Error -12 
Error -8 






2-14,2-18 
3-15,3-19,4-1 


c 




Error -6 
Error -2 






3-19,3-22,4-1 
3-8 


Card Reader 


14 


Error 005 






5-1 


Carriage Return/Line Feed 


2-13 


Error 006 






3-18 


Cassette 


14 


Error 009 






3-21 


CL 


2-4,3-3,3-7,3-16 


Error 010 






3-25 


CLOSE 


2-3, 2-6, A-3 


Error 011 






3-21 


CO 


3-8 


Error 012 






3-17 


Control D 


3-23 


Error 014 






3-21 


CR 


1-5,24,3-3,3-8,3-11,3-15, 


Error 015 






3-18,3-27 




3-19,3-26,4-1 


Error 018 






3-21 


CREAT 


1-5,2-3,2-4,2-7,3-15 


Error 023 






3-20 


Cyclic 


1-5 


Error 059 
Error 060 






3-11,3-15 
3-15,3-25 


D 




EX 






3-25,3-28 






Exclusive Open 


] 


[-3, 1-7, 2-13, 3-9, A-2 


DC 


2-4,3-10, 3-1 1,3-17, A- 1 


Extendable Files 






1-6 


D.RTR 


1-7,2-1,2-7,2-11,2-13,2-20, 
3-11,3-19,5-1 


F 








Directory Conflict 


1-7 










Disc Directory 


1-5, 2-1 


FCONT 






2-8 


Disc Organization 


14 


File Conflict 






1-7 


DL 


3-11,3-16 


File Directory 






1-5, 2-1 


DU 


3-13, 3-14, 3-26, 3-27 


File Organization 






14 


DVROO 


14,2-8,3-9,3-17,3-26,3-27 


File Security 






1-7 


DVR01 


2-8 


FMGR, SCHEDULE 






3-6 


DVR02 


2-8 


FSTAT 






2-9 


DVR05 


3-17 


Function Code 






2-8 


DVR09 


14 










DVR12 


3-9 


H 








DVR30 


3-17 










DVR31 


3-17, 3-26 


Honesty Mode 






2-13 
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Index 



FMP 



INDEX (Continued) 



Imbedded Blanks 
IN 



Leader 

LI 

LL 

LO 

LOCF 

M 

Magnetic Tape 

MC 

MR 

MS 

N 

NAMF 

Non-Exclusive Open 
Non-Update 
Null 



ON, FMGR 
OPEN 



PACK 

Page Eject 

Parse 

PK 

POSNT 

Post 

PU 

PURGE 





R (Continued) 






Page 






Page 


2-3, 3-3 


Record Terminator 




2-13 


3-15,5-1 


Relative Track 




1-4, 1-5 




RMPAR 




2-1,2-13,3-7,3-18 




RN 




3-20,3-21 




RP 




3-20,3-21,3-28,3-29 


1-4,2-8,2-13,3-14,3-23 


Rubout 




1-6 


3^1, 3-16,3-27 


RWNDF 




2-3, 2-20 


3-7,3-16 








3-17 


s 






2-5,2-10,3-4 










SA 




3-22, 3-26, 3-28 




SC03 




3-7 


1-4, 2-8, 3-26 
3-10,3-15,3-17 


Security 

Sector 

SP 


1-3, 1-7, A-3 

1-4, 2-1, 2-10, A-2, A-3, A-4 

3-20, 3-21, 3-28, 3-29, A-4 


3-18, 3-26 
3-7,3-18,3-27,3-28 


ST 
SV 

T 




3-21,3-23,3-26,3-27 
3-24 


2-3,2-4, 2-11, A-3 

1-3,1-7,2-13 

1-6,2-12,2-13 


TR 

Trailing Blanks 




3-24, 4-1 

2-3 


3-1,3-15 


u 








Update 




1-6, 2-12, 2-13, A-3 


3-5, 3-26, 3-27, 3-28, 3-29 








2-3,2-4,2-12,4-1 


w 








WRITE 




1-4 


1-5,3-15 


WRITF 




2-5,2-21 


1-4 

3-1 


z 






3-19,4-1 

2-3, 2-14 


Zero Length Record 


1-4, 1-7 


,2-18,2-22,3-13,3-14, 


2-3, 2-13 




3-16, 3-22, 3-23, 3-26, 3-27, A-4 


3-20, 3-28 








2-3, 2-4, 2-16, 4-1, A-3 


?? 




3-15,3-25 



READ 
READF 



1-4 
2-5,2-15,2-17 



32767 



2-3, 3-3 



2-4, 2-7, 3-3 
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ELECTRONIC 
SALES & SERVICE OFFICES 



UNITED STATES 



ALABAMA 

P.O. Box 4207 

2003 Syrd Spring Road S.W. 

Huntsville 35802 

Tel: (205) 881-4591 

TWX: 810-726-2204 

ARIZONA 

2336 E. Magnolia St. 
Phoenix 85034 
Tel: (602) 244-1361 
TWX: 910-951-1330 

5737 East Broadway 
Tucson 85711 
Tel: (602) 298-2313 
TWX: 910-952-1162 

CALIFORNIA 

1430 East Orangethorpe Ave. 
Fullerton 92631 
Tel: (714) 870-1000 
TWX: 910-592-1288 

3939 Lankershim Boulevard 
North Hollywood 91604 
Tel: (213) 877-1282 
TWX: 910-499-2170 

6305 Arizona Place 
Los Angeles 90045 
Tel: (213) 649-2511 
TWX: 910-328-6148 

1101 Embarcadero Road 
Palo Alto 94303 
Tel: (415) 327-6500 
TWX: 910-373 1280 

2220 Watt Ave. 
Sacramento 95825 
Tel: (916) 482-1463 
TWX: 910-367-2092 

9606 Aero Drive 
P.O. Box 23333 
San Diego 92123 
Tel: (714) 279-3200 
TWX: 910-335-2000 

COLORADO 

7965 East Prentice 
Englewood 80110 
Tel: (303) 771-3455 
TWX: 910-935-0705 



CONNECTICUT 

12 Lunar Drive 
New Haven 06525 
Tel: (203)389-6551 
TWX: 710-465-2029 

FLORIDA 

P.O. Box 24210 
2806 W. Oakland Park Blvd. 
Ft. Lauderdale 33307 
Tel: (305) 731-2020 
TWX: 510-955-4099 

P.O. Box 13910 
6177 Lake Ellenor Dr 
Orlando, 32809 
Tel: (305) 859-2900 
TWX: 810-850-0113 

GEORGIA 

P.O. Box 28234 
450 Interstate North 
Atlanta 30328 
Tel: (404) 436-6181 
TWX: 810-766-4890 

HAWAII 

2875 So. King Street 
Honolulu 96814 
Tel: (808) 955-4455 

ILLINOIS 

5500 Howard Street 
Skokle 60076 
Tel: (312) 677-0400 
TWX: 910-223-3613 

INDIANA 

3839 Meadows Drive 
Indianapolis 46205 
Tel: (317) 545-4891 
TWX: 810-341-3263 

LOUISIANA 

P. 0. Box 840 

3239 Williams Boulevard 

Renner 70062 

Tel: (504) 721-6201 

TWX: 810-955-5524 



MARYLAND 

6707 Whitestone Road 
Baltimore 21207 
Tel: (301) 944-5400 
TWX: 710-862-9157 

P.O. Box 1648 
2 Choke Cherry Road 
Rockville 20850 
Tel: (301) 948-6370 
TWX: 710-828-9684 

MASSACHUSETTS 

32 Hartwell Ave. 
Lexington 02173 

Tel: (617) 861-8960 
TWX: 710-326-6904 

MICHIGAN 

23855 Research Drive 
Farmington 48024 
Tel: (313) 476-6400 
TWX: 810-242-2900 

MINNESOTA 

2459 University Avenue 
St. Paul 55114 
Tel: (612) 645-9461 
TWX: 910-563-3734 

MISSOURI 

11131 Colorado Ave. 
Kansas City 64137 
Tel: (816) 763-8000 
TWX: 910-771-2087 

148 Weldon Parkway 
Maryland Heights 63043 
Tel: (314) 567-1455 
TWX: 910-764-0830 

•NEVADA 
Las Vegas 

Tel: (702) 382-5777 

NEW JERSEY 

W. 120 Century Road 
Paramus 07652 
Tel: (201) 265-5000 
TWX: 710-990-4951 
1060 N. Kings Highway 
Cherry Hill 08034 
Tel: (609) 667-4000 
TWX: 710-892-4945 



NEW MEXICO 

P.O. Box 8366 

Station C 

6501 Lomas Boulevard N.E. 

Albuquerque 87108 

Tel: (505) 265-3713 

TWX: 910-989-1665 

156 Wyatt Drive 
Las Cruces 88001 
Tel: (505) 526-2485 
TWX: 910-983-0550 

NEW YORK 

6 Automation Lane 
Computer Park 
Albany 12205 
Tel: (518) 458-1550 
TWX: 710-441-8270 

1219 Campville Road 
Endlcott 13760 
Tel: (607) 754-0050 
TWX: 510-252-0890 

New York City 

Manhattan, Bronx 
Contact Paramus, NJ Office 
Tel: (201) 265-5000 
Brooklyn, Queens, Richmond 
Contact Woodbury, NY Office 
Tel: (516) 921-0300 

82 Washington Street 
Poughkeepsie 12601 

Tel: (914) 454-7330 
TWX: 510-248-0012 

39 Saginaw Drive 
Rochester 14623 
Tel: (716) 473-9500 
TWX: 510-253-5981 

5858 East Molloy Road 
Syracuse 13211 
Tel: (315) 454-2486 
TWX: 710-541-0482 

1 Crossways Park West 
Woodbury 11797 
Tel: (516) 921-0300 
TWX: 510-221-2168 



NORTH CAROLINA 

P.O. Box 5188 
1923 North Main Street 
High Point 27262 
Tel: (919) 885-8101 
TWX: 510-926-1516 

OHIO 

25575 Center Ridge Road 
Cleveland 44145 
Tel: (216) 835-0300 
TWX: 810-427-9129 

330 Progress Rd. 
Dayton 45449 
Tel: (513) 859-8202 
TWX: 810-459-1925 

1120 Morse Road 
Columbus 43229 

Tel: (614) 846-1300 

OKLAHOMA 

P.O. Box 32008 
Oklahoma City 73132 
Tel: (405) 721-0200 
TWX: 910-830-6862 

OREGON 

17890 SW Boones Ferry Road 
Tualatin 97062 
Tel: (503) 620-3350 
TWX: 910-467-8714 

PENNSYLVANIA 

2500 Moss Side Boulevard 
Monroeville 15146 

Tel: (412) 271-0724 
TWX: 710-797-3650 

1021 8th Avenue 

King of Prussia Industrial Park 

King of Prussia 19406 

Tel: (215) 265-7000 

TWX: 510-660-2670 

RHODE ISLAND 

873 Waterman Ave. 
East Providence 02914 
Tel: (401) 434-5535 
TWX: 710-381-7573 

•TENNESSEE 
Memphis 

Tel: (901) 274-7472 



TEXAS 

P.O. Box 1270 
201 E. Arapaho Rd. 
Richardson 75080 

Tel: (214) 231-6101 
TWX: 910-867-4723 
P.O. Box 27409 
6300 Westpark Drive 
Suite 100 
Houston 77027 
Tel: (713) 781-6000 
TWX: 910-881-2645 
231 Billy Mitchell Road 
San Antonio 78226 
Tel: (512) 434-4171 
TWX: 910-871-1170 

UTAH 

2890 South Main Street 
Sal': Lake City 84115 
Tel: (801) 487-0715 

TWX: 910-925-5681 
VIRGINIA 
P.O. Box 6514 
2111 Spencer Road 
Richmond 23230 
Tel: (803) 285-3431 
TWX: 710-956-0157 
WASHINGTON 
Bellefield Office Pk. 
12C3- 114th SE 
Bellevue 98004 
Tel: (206) 454-3971 
TWX: 910-443-2303 
•WEST VIRGINIA 
Charleston 
Tel: (304) 345-1640 
WISCONSIN 
9431 W. Beloit Road 
Suite 117 
Milwaukee 53227 

Tel (414) 541-0550 

FOR U.S. AREAS NOT 
LISiTED: 

Contact the regional office near- 
est you: Atlanta, Georgia . . . 
Noith Hollywood, California... 
Paramus, New Jersey . . . Skokie, 
Illinois. Their complete ad- 
dresses are listed above. 
•Service Only 



CANADA 

ALBERTA 

Hewlett-Packard (Canada) Ltd. 

11748 Kingsway Ave. 

Edmonton 

Tel: (403) 452-3670 

TWX: 610-831-2431 



BRITISH COLUMBIA 

Hewlett-Packard (Canada) Ltd. 
4608 Canada Way 
North Burnaby 2 
Tel: (604) 433-8213 
TWX: 610-922-5059 



MANITOBA 

Hewlett-Packard (Canada) Ltd. 

513 Century St. 

Winnipeg 

Tel: (204) 786-7581 

TWX: 610-671-3531 



NOVA SCOTIA 

Hewlett-Packard (Canada) Ltd. 

2745 Dutch Village Rd. 

Suite 210 

Halifax 

Tel: (902) 455-0511 

TWX: 610-271-4482 



ONTARIO 

Hewlett-Packard (Canada) Ltd. 
1785 Woodward Dr. 
Ottawa 3 

Tel: (613) 255-6180, 255-6530 
TWX: 610-562-8968 

Hewlett-Packard (Canada) Ltd. 

50 Galaxy Blvd. 

(texdale 

Tel: (416) 677-9611 
TWX: 610-492-4246 



QUEBEC 

Hewlett-Packard (Canada) Ltd. 

275 Hymus Boulevard 

pointe Claire 

Tel: (514) 697-4232 

TWX: 610-422-3022 

Telex, 01-20607 

FOR CANADIAN AREAS NOT 
LISTED: 

Contact Hewlett-Packard (Can- 
ada) Ltd. in Pointe Claire, at 
the complete address listed 
above. 



CENTRAL AND SOUTH AMERICA 



ARGENTINA 

Hewlett-Packard Argentina 

S.A.C.e.l 

Lavalle 1171 -3° 

Buenos Aires 

Tel: 35-0436, 35-0627, 35-0341 

Telex: 012-1009 

Cable: HEWPACK ARG 

BOLIVIA 

Stambuk & Mark (Bolivia) LTDA. 

Av. Mariscal, Santa Cruz 1342 

La Paz 

Tel: 40626, 53163, 52421 

Telex: 3560014 

Cable: BUKMAR 

BRAZIL 

Hewlett-Packard Do Brasil 

I.E.C. Ltda. 

Rua Frei Caneca 1119 

01307-Sao Paulo-SP 

Tel: 288-7111, 287-5858 

Telex: 309151/2/3 

Cable; HEWPACK Sao Paulo 

Hewlett-Packard Do Brasil 

I.E.C. Ltda. 

Praca Dom Fellciano, 78 

90000-Porto Alegre-RS 

Rio Grande do Sul (RS) Brasil 

Tel: 25-8470 

Cable: HEWPACK Porto Alegre 



Hewlett-Packard Do Brasil 

I.E.C. Ltda. 

Rua da Matriz, 29 

20000-RiO de Janeiro GB 

Tel: 266-2643 

Telex: 210079 HEWPACK 

Cable: HEWPACK Rio de Janeiro 

CHILE 

Hector Calcagni y Cia, Ltda. 

Casilla 16.475 

Santiago 

Tel: 423 96 

Cable: CALCAGNI Santiago 

COLOMBIA 

Instrumentacion 

Henrik A. Langebaek & Kier S.A. 

Carrera 7 No. 48-59 

Anartado Ae>eo 6287 

Bogota, 1 D.E. 

Tel: 45-78-06, 45-55-46 

Cable: AARIS Bogota 

Telex: 44400INSTC0 

COSTA RICA 

Lie. Alfredo Gallegos Gurdi&n 

Apartado 10159 

San Jose 

Tel: 21-86-13 

Cable: GALGUR San Jos6 



ECUADOR 

Laboratories de Radio-lngenieria 

Calle Guayaquil 1246 

Post Office Box 3199 

Quito 

Tel: 212-496; 219-185 

Cable: HORVATH Quito 

EL SALVADOR 

Electronic Associates 
Apartado Postal 1682 
Centro Comercial Gigante 
San Salvador, El Salvador C.A. 
Paseo Escalon 4649-4° Piso 
Tel: 23-44-60, 23-32-37 
Cable: ELECAS 

GUATEMALA 

IPESA 

5a via 2-01, Zona 4 

Guatemala City 

Tel: 63-6-27 & 64-7-86 
Telex: 4192 TELTRO GU 

MEXICO 

Hewlett-Packard Mexicana, 

S.A. de C.V. 

Torres Adal.d No. 21, 11 J Piso 

Col. del Valle 

Mexico 12, D.F. 

Teh 543-42-32 

Telex: 017-74-507 



NICARAGUA 

Roberto TerSn G. 

Apartado Postal 689 

Edificio TerSn 

Managua 

Tel: 3451, 3452 

Cable: ROTERAN Managua 

PANAMA 

Electr6nico Balboa, S.A. 

P.O. Box 4929 

Ave. Manuel Espinosa No. 13-50 

Bldg. Alina 

Panama City 

Tel: 230833 

Telex: 3481103, Curunda, 

Canal Zone 

Cable: ELECTRON Panama City 

PARAGUAY 

Z. J. Melamed S.R.L. 
Division: Aparatos y Equipos 

Medicos 
Division: Aparatos y Equipos 

Scientificos y de 

Investigacion 
P.O. Box 676 

Chile, 482, Edificio Victoria 
Asuncion 

Tel: 4-5069, 4-6272 
Cable: RAMEL 



PERU 

Compania Electro M6dica S.A. 

Ave. Enrique Canaual 312 

San Isidro 

Casilla 1030 

Lima 

Tel: 22-3900 

Cable: ELMED Lima 

PUERTO RICO 

San Juan Electronics, Inc. 

P.O. Box 5167 

Ponce de Leon 154 

Pda. 3-PTA de Tierra 

San Juan 00906 

Tel: (809) 725-3342, 722-3342 

Cable: SATRONICS San Juan 

Telex: SATRON 3450 33? 



URUGUAY 

Pablo Ferrando S.A. 

Comercial e Industrial 

Avenida Italia 2877 

Casilla de Correo 370 

Montevideo 

Tel: 40-3102 

Cable: RADIUM Montevideo 

VENEZUELA 

Hewlett-Packard de Venezuela 

C.A. 

Apartado 50933 

Edificio Segre 

Tccera Transversal 

Los Ruices Norte 

Caracas 107 

Tel: 35-00-11 

Telex: 21146 HEWPACK 

Cable: HEWPACK Caracas 

FOR AREAS NOT LISTED, 

CONTACT: 

Hewlett-Packard 

Inter-Americas 

3200 Hillview Ave. 

Palo Alto, California 94304 

Tel: (415) 493-1501 

TWX: 910-373-1267 

Cable: HEWPACK Palo Alto 

Telex: 034-8300, 034-8493 



EUROPE 

AUSTRIA 

Hewlett-Packard Ges.m.b.H 

Handelska 52/3 

P.O. Box 7 

A-1205 Vienna 

Teh (0222) 33 66 06 to 09 

Cable: HEWPAK Vienna 

Telex: 75923 hewpak a 

BELGIUM 

Hewlett-Packard Benelux 

S.A./N.V. 

Avenue de Col-Vert, 1, 

(Groenkraaglaan) 

B-1170 Brussels 

Tel: (02) 72 22 40 

Cable: PALOBEN Brussels 

Telex: 23 494 paloben bru 

DENMARK 

Hewlett-Packard A/S 
Datavej 38 
DK-3460 Birkerod 
Tel- (01) 81 66 40 
Cable HEWPACK AS 
Telex: 166 40 hp as 

Hewlett-Packard A/S 
Torvet 9 

DK-8600 Silkeborg 
Tel: (06) 82-71-66 
Telex: 166 40 hp as 
Cable: HEWPACK AS 

FINLAND 

Hewlett-Packard Oy 

Buievardi 26 

P.O. Box 12185 

SF-00120 Helsinki 12 

Tel: (90) 13730 

Cable: HEWPACKOY Helsinki 

Telex: 12-15363 hel 

FRANCE 

Hewlett-Packard France 
Quartier de Courtaboeuf 
Boite Postale No. 6 
F-91401 Orsay 
Tel: (1) 907 78 25 
Cable: HEWPACK Orsay 
Telex: 60048 



Hewlett-Packard France 
4 Quai des Etroits 
F-69321 Lyon Cedex 1 
Tel: (78) 42 63 45 
Cable: HEWPACK Lyon 
Telex: 31617 

Hewlett-Packard France 
29 rue de la Gare 
F-31700 Blagnac 
Tel: (61) 85 82 29 
Telex: 51957 

GERMAN FEDERAL 
REPUBLIC 

Hewlett-Packard GmbH 
Vertriebszentrale Frankfurt 
Bernerstrasse 117 
Postfach 560 140 
0-6000 Frankfurt 56 
Tel: (0611) 50 04-1 
Cable: HEWPACKSA Frankfurt 
Telex: 41 32 49 fra 

Hewlett-Packard Gmb' 
Vertriebsbiiro Boblingfj. 
Herrenbergerstrasse 11 
D-7030 Boblingen, Wurtl'.mbe: 
Tel: (07031) 66 72 87 
Cable: HEPAK Boblingen 
Telex: 72 65 739 bbn 

Hewlett-Packard GmbH 
Vertriebsbiiro Dusseldorf 
Vogelsanger Weg 38 
D-4000 Dusseldorf 
Tel: (0211! 63 80 31 35 
Telex: 85/86 533 hpdd d 

Hewlett-Packard GmbH 

Vertriebsbiiro Hamburg 

Wendenstr. 23 

D-2000 Hamburg 1 

Tel: (0411) 24 13 93 

Cable: HEWPACKSA Hamburg 

Telex: 21 63 032 hphh d 

Hewlett-Packard GmbH 
Vertriebsburo Hannover 
Mellendorfer Strasse 3 
D-3000 Hannover - Kleefeld 
Tel: (0311) 55 06 26 



Hewlett-Packard GmbH 

Vertriebsbiiro Miinchen 

Unterhachinger Strasse 28 

1SAR Center 

D-8012 Ottobrunn 

Tel: (0811) 601 30 61/7 

Telex: 52 49 85 

Cable: HEWPACKSA Miichen 

(West Berlin) 

Hewlett-Packard GmbH 
Vertriebsburo Berlin 
Wilmersdorfer Strasse 113/114 
D-1000 Berlin W. 12 
Tel: (0311) 3137046 
Telex: 18 34 05 hpbln d 

GREECE 

Kostas Karayannis 
18, Ermou Street 
GR-Athens 126 
Tel: 3230-303, 3230-305 
Cable: RAKAR Athens 
Telex: 21 59 62 rkar gr 

IRELAND 

Hewlett-Packard Ltd. 
224 Bath Road 
GB-Stough, SLl 4 DS, Bucks 
Tel: Slough (0753) 33341 
Cable: HEWPIE Slough 
Telex: 848413 

Hewlett-Packard Ltd. 
The Graftons 
Stamford New Road 
Altrincham, Cheshire, England 

Tel: (061) 928-8626 
Telex: 668068 

ITALY 

Hewlett-Packard Italiana S.p.A. 
Via Amerigo Vespucci 2 
1-20124 Milan 
Tel: 12; 6251 (10 lines) 
Cable.- HEWPACKIT Milan 
Telex: 32046 

Hewlett-Packard Italiana S.p.A. 

Piazza Marconi, 25 

1-00144 Rome - Eur 

Tel: (6j 5912544/5, 5915947 

Cable: HEWPACKIT Rome 

Telex: 61514 



Hewlett-Packard Italiana S.p.A. 
Vicolo Pastori, 3 
1-35100 Padova 
Tel: (49) 66 40 62 
Telex: 32046 via Milan 

Hewlett-Packard Italiana S.p.A. 
Via Colli. 24 
1-10129 Turin 
Tel: (11) 53 82 64 
Telex: 32046 via Milan 

LUXEMBURG 

Hewlett-Packard Benelux 

S.A./N.V. 

Avenue de Col-Vert, 1, 

(Groenkraaglaan) 

B-1170 Brussels 

Tel: (03/02) 72 22 40 

Cable: PALOBEN Brussels 

Telex: 23 494 

NETHERLANDS 

Hewlett-Packard Benelux/N.V, 

Weerdestein 117 

P.O. Box 7825 

NL-AmsterrJam, Z1011 

Tel: 020-42 77 77, 44 29 66 

Cable: PALOBEN Amsterdam 

Telex: 13 216 hepa nl 

NORWAY 

Hewlett-Packard Norge A/S 
Nesveien 13 
Box 149 
N-1344 Haslum 
Tel: (02) 53 83 60 
Telex: 16621 hpnas n 

PORTUGAL 

Telectra-Empresa Te"cnica de 

ElSctricos S.a.r.l. 

Rua Rodrigo da Fonseca 103 

P.O. Box 2531 

P-Lisbon 1 

Tel: (19)68 60 72 

Cable: TELECTRA Lisbon 

Telex: 1598 



SPAIN 

Hewlett-Packard Espanola, S.A. 
Jerez No 8 
E-Madrid 16 
Tel: 458 26 00 
Telex: 23515 hpe 

Hewlett-Packard Espanoia, S.A. 
Milanesado 21-23 
E-Barcelona 17 

Tel: (3) 203 62 00 
Telex: 52603 hpbe e 

SWEDEN 

Hewlett-Packard Sverige AB 

Enighetsvagen 1-3 

Fack 

S-161 20 Bromma 20 

Tel: (08) 98 12 50 

Cable: MEASUREMENTS 

Stockholm 
Telex: 10721 

Hewlett-Packard Sverige AB 
Hagakersgatan 9C 
S-431 41 Molndal 
Tel: (031) 27 68 00 01 
Telex: Via Bromma 

SWITZERLAND 

Hewlett Packard (Schweiz) AG 

Ziircherstrasse 20 

P.O. Box 64 

CH-8952 Schlieren Zurich 

Tel: (01) 98 18 21 '24 

Cable: HPAG CH 

Telex: 53933 hpag ch 

Hewlett-Packard (Schweiz) AG 

9, Chemin Louis-Pictet 

CH 1214 Vernier— Geneva 

Tel: 1022) 41 4950 

Cable: HEWPACKSA Geneva 

Telex: 27 333 hpsa ch 

TURKEY 

Telekom Engineering Bureau 

Saglik Sok No. 15/1 

Ayaspasa-Beyoglu 

P.O. Box 437 Beyoglu 

TR-lstanbul 

Tel: 49 40 40 

Cable; TELEMATION Istanbul 



UNITED KINGDOM 

Hewlett-Packard Ltd. 
224 Bath Road 
GB-Slough, SLl 4 DS, Bucks 
Tel Slough (0753) 33341 
Cable: HEWPIE Slough 
Telux; 848413 
Hewlett-Packard Ltd. 
"Tfe Graftons" 
Sta-nford New Road 
GB-Altrincham, Cheshire 
Tel (061) 928-8626 
Telex: 668068 

Hewlett-Packard Ltd's registered 

address for V.A.T. purposes 

only: 

70, Finsbury Pavement 

London, EC2A1SX 

Registered No: 690597 

SOCIALIST COUNTRIES 
PLEASE CONTACT: 

Hewlett-Packard Ges.m.b.H. 

Handelskai 52/3 

P.O. Box 7 

A-1205 Vienna 

Ph: (0222) 33 66 06 to 09 

Cable: HEWPACK Vienna 

Telax: 75923 hewpak a 

ALL OTHER EUROPEAN 
COUNTRIES CONTACT: 

Hewlett-Packard S.A. 
Rue rJu Bois-du-Lan 7 
P.O. Box 85 
CH-1217 Meyrin 2 Geneva 

Switzerland 
Tel (022) 41 54 00 
Cable: HEWPACKSA Geneva 
Telex: 2 24 86 



AFRICA, ASIA, AUSTRALIA 



ANGOLA 

Telectra-Empresa Tecnica 
de Equipamentos Electricos 
SARL 

Rua de Barbosa, Rodrigues, 
42-1 , Dl- 

P.O. Box 6487 

Luanda 

Cable: TELECTRA Luanda 

AUSTRALIA 

Hewlett-Packard Australia 

Pty. Ltd. 
22-26 Weir Street 
Glen Iris, 3146 
Victoria 

Tel: 20-1371 (6 lines) 
Cable: HEWPARD Melbourne 
Telex: 31 024 

Hewlett-Packard Australia 

Pty. Ltd. 
31 Bridge Street 
Pymble, 

New South Wales, 2073 
Tel: 449 6566 
Telex: 21561 
Cable: HEWPARD Sydney 

Hewlett-Packard Australia 

Pty. Ltd. 
97 Churchill Road 
Prospect 5082 
South Australia 
Tel: 44 8151 
Cable: HEWPARD Adelaide 

Hewlett-Packard Australia 

Pty. Ltd. 
1st Floor, Suite 12/13 
Casablanca Buildings 
196 Adelaide Terrace 
Perth, W.A. 6000 
Tel: 25-6800 
Cable: HEWPARD Perth 

Hewlett-Packard Australia 

Pty. Ltd. 
10 Woolley Street 
P.O. Box 191 
Dickson A.C.T. 2602 
Tel: 49-8194 
Cable: HEWPARD Canberra ACT 

Hewlett-Packard Australia 
Pty. Ltd. 

2nd Floor, 49 Gregory Terrace 
Brisbane, Queensland, 4000 
Tel: 29 1544 

CEYLON 

United Electricals Ltd. 
P.O. Box 681 
60, Park St. 
Colombo 2 

Tel: 26696 

Cable: HOTPOINT Colombo 



CYPRUS 

Kypronics 

19 Gregorios & Xenopoulos Road 

P.O. Box 1152 

CY-Nicosia 

Tel: 45628/29 

Cable: KYPRONICS PANDEHIS 

ETHIOPIA 

African Salespower & Agency 

Private Ltd., Co. 
P. 0. Box 718 
58/59 Cunningham St. 
Addls Ababa 
Tel: 12285 
Cable: ASACO Addisababa 

HONG KONG 

Schmidt & Co. (Hong Kong) Ltd. 

P.O. Box 297 

1511, Prince's Building 

15th Floor 

10, Chater Road 

Hong Kong 

Tel: 240168, 232735 

Telex: HX4766 SCHMCO 

Cable: SCHMIDTCO Hong Kong 

INDIA 

Blue Star Ltd. 
Kasturi Buildings 
Jamshedji Tata Rd. 
Bombay 400 020 
Tel: 29 50 21 
Telex: 3751 
Cable: BLUEFROST 

Blue Star Ltd. 

Sahas 

414/2 Vlr Savarkar Marg 

Prabhadevi 

Bombay 400 025 

Tel: 45 73 01 

Telex: 3751 

Cable: BLIJESTAR 

Blue Star Ltd. 
14/40 Civil Lines 
Kampur 208 001 
Tel: 6 88 82 
Cable: BLUESTAR 

Blue Star, Ltd. 
7 Hare Street 
P.O. Box 506 
Calcutta 700 001 
Tel: 23-0131 
Telex: 655 
Cable: BLUESTAR 

Blue Star Ltd. 
Blue Star House, 
34 Ring Road 
Lajpat Nagar 
New Delhi no 024 
Tel: 62 32 76 
Telex: 463 
Cable: BLUESTAR 

Blue Star, Ltd. 
Blue Star House 
11/11A Magarath Road 
Bangalore 560 025 
Tel: 51473 
Telex: 430 
Cable: BLUESTAR. 



Blue Star, Ltd. 

1-1-117/1 

Sarojini Devi Road 

Secunderabad 500 003 

Tel: 7 63 91,7 73 93 

Cable: BLUEFROST 

Telex: 459 

Blue Star, Ltd. 

23/24 Second Line Beach 

Madras 600 001 

Tel: 2 39 55 

Telex: 379 

Cable: BLUESTAR 

Blue Star, Ltd. 
IB Kaiser Bungalow 
DindM Road 
Jamshedpur 831 001 
Tel: 38 04 
Cable: BLUESTAR 
Telex: 240 

INDONESIA 

Bah Bolon Trading Coy. N.V. 

Dialah Merdeka 29 

Bandung 

Tel: 4915; 51560 
Cable: ILMU 
Telex: 08-809 

IRAN 

Multicorp International Ltd. 

Avenue Soraya 130 

P.O. Box 1212 

IR-Teheran 

Tel: 83 10 35-39 

Cable: MULTICORP Tehran 

Telex: 2893 MCI TN 

ISRAEL 

Electronics & Engineering 

Div. of Motorola Israel Ltd. 
17 Amlnadav Street 
Tel-Aviv 

Tel: 36941 (3 lines) 
Cable: BASTEL Tel-Aviv 
Telex: 33569 

JAPAN 

Yokogawa-Hewlett-Packard Ltd. 

Ohashl Building 

1-59-1 Yoyogi 

Shibuya-ku, Tokyo 

Tel: 03-370-2281/92 

Telex: 232-2024YHP 

Cable: YHPMARKET TOK 23-724 

Yokogawa-Hewlett-Packard Ltd. 

Nisei Ibaragi Bldg. 

2-2-8 Kasuga 

Ibaragi-Shi 

Osaka 

Tel: (0726)23-1641 

Telex: 5332-385 YHP OSAKA 

Yokogawa-Hewlett-Packard Ltd. 
Nakamo Building 
No. 24 Kamisasazima-cho 
Nakamura-ku, Nagoya City 
Tel: (052) 571-5171 

Yokogawa-Hewlett-Packard Ltd. 

Nitto Bldg. 

2-4-2 Shinohara-Kita 

Kohoku-ku 

Yokohama 222 

Tel: 045-432-1504 

Telex: 382-3204 YHP YOK 



Yokogawa-Hewlett-Packard Ltd. 

Chuo Bldg. 

Rm. 603 3, 

2-Chome 

IZUMI-CHO, 

Mito, 310 

Tel: 0292-25-7470 

KENYA 

Kenya Kinetics 
P.O. Box 18311 
Nairobi, Kenya 
Tel: 57726 
Cable: PROTON 

KOREA 

American Trading Company 

Korea, 
I. P.O. Box 1103 
Dae Kyung Bldg., 8th Floor 
107 Sejong-Ro, 
Chongro-Ku, Seoul 
Tel: (4 lines) 73-8924-7 
Cable: AMTRACO Seoul 

LEBANON 

Constantin E. Macridis 

P.O. Box 7213 

RL-Beirut 

Tel: 220846 

Cable: ELECTRONUCLEAR Beirut 

MALAYSIA 

MECOMB Malaysia Ltd. 

2 Lorong 13/6A 

Section 13 

Petaling Jaya, Selangor 

Cable: MECOMB Kuala Lumpur 

MOZAMBIQUE 

A.N. Goncalves, Lta. 
162, Av. D. Luis 
P.O. Box 107 
Lourenco Marques 
Tel: 27091, 27114 
Telex: 6-203 Negon Mo 
Cable: NEGON 

NEW ZEALAND 

Hewlett-Packard (N.Z.) Ltd. 

94-96 Dixon Street 

P.O. Box 9443 

Courtenay Place, 

Wellington 

Tel: 59-559 

Telex: 3898 

Cable; HEWPACK Wellington 

Hewlett-Packard (N.Z.) Ltd. 

Pakuranga Professional Centre 

267 Pakuranga Highway 

Box 51092 

Pakuranga 

Tel: 569-651 

Cable: HEWPACK, Auckland 

NIGERIA 

TEIL (Masacon Division) 

25 Moronu Street, Suru-Lere, 

P.O. Box 5707 

Lagos 

Tel: 34545 

Cable: THETEIL Lagos 



PAKISTAN 

Mushko & Company, Ltd. 
Gasman Chambers 
Abdullah Haroon Road 
Karachi 3 

Tel: 511027, 512927 
Cable: COOPERATOR Karachi 

Mushko & Company, Ltd. 

38B, Satellite Town 

Rawalpindi 

Tel: 41924 

Cable: FEMUS Rawalpindi 

PHILIPPINES 

Electromex, Inc. 

6th Floor, Amalgamated 

Development Corp. Bldg. 
Ayala Avenue, Makati, Rizal 
C.C.P.O. Box 1028 
Makati, Rizal 
Tel: 86-18-87, 87-76-77, 

87-86-88, 87-18-45, 88-91-71, 

83-81-12, 83-82-12 
Cable: ELEMEX Manila 

SINGAPORE 

Mechanical and Combustion 
Engineering Company Ltd. 
10/12, Jalan Kilang 
Red Hill Industrial Estate 
Singapore, 3 
Tel: 647151 (7 lines) 
Cable: MECOMB Singapore 

Hewlett-Packard Far East 

Area Office 

P.O. Box 87 

Alexandra Post Office 

Singapore 3 

Tel: 633022 

Cable: HEWPACK SINGAPORE 

SOUTH AFRICA 

Hewlett Packard South Africa 

(Pty.), Ltd. 
P.O. Box 31716 
Braamfontein Transvaal 
Milnerton 
30 De Beer Street 
Johannesburg 
Tel: 725-2080, 725-2030 
Telex: 0226 JH 
Cable: HEWPACK Johannesburg 

Hewlett Packard South Africa 

(Pty.), Ltd. 
Breecastle House 
Bree Street 
Cape Town 
Tel: 2-6941/2/3 
Cable: HEWPACK Cape Town 
Telex: 0006 CT 

Hewlett Packard South Africa 

(■Pty.;, Ltd. 
641 Ridge Road, Durban 
P.O. Box 99 
Overport, Natal 
Tel: 88-6102 
Telex: 567954 
Cable: HEWPACK 



TAIWAN 

Hewlett Packard Taiwan 

39 Chung Shiao West Road 

Sec. 1 

Overseas Insurance 

Corp. Bldg. 7th Floor 

Taipei 

Tel 389160,1,2, 375121, 

Ext. 240-249 

Telex: TP824 HEWPACK 

Cable: HEWPACK Taipei 

THAILAND 

UNIMESA Co., Ltd. 

Chongkoinee Building 

56 Suriwongse Road 

Bangkok 

Tel: 37956, 31300, 31307, 

37540 
CaMe: UNIMESA Bangkok 

UGANDA 

Uganda Tele-Electric Co., Ltd. 

P.O. Box 4449 

Kampala 

Tel 57279 

Cable: COMCO Kampala 

VIETNAM 

Peninsular Trading inc. 
P.O. Box H-3 

216 Hien-Vuong 
Saiijon 

Tel: 20-805, 93398 

Cable: PENTRA, SAIGON 242 

ZAMBIA 

R. J. Tilbury (Zambia) Ltd. 

P.O. Box 2792 

Lusaka 

Zambia, Central Africa 

Tel: 73793 

Cable: ARJAYTEE, Lusaka 

MEDITERRANEAN AND 
MIDDLE EAST COUNTRIES 
NOT SHOWN PLEASE 
CONTACT: 

Hewlett-Packard 
Co-ordination Office for 
Mediterranean and Middle 
East Operations 
Pia.;za Marconi 25 
1-00144 Rome-Eur, Italy 
Tel: (6) 59 40 29 
Cable: HEWPACKIT Rome 
Telsx: 61514 

OTHER AREAS NOT 

LISTED, CONTACT: 
Hewlett-Packard 

Export Trade Company 
3200 Hillview Ave. 
Palo Alto, California 94304 
Tel (415) 326-7000 

(Feb. 71 493-1501) 
TWX: 910-373-1267 
Cable: HEWPACK Palo Alto 
Telex: 034-8300, 034-S493 
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